QiNetix Registry Keys and Parameters


Overview

In order to perform advanced troubleshooting and other environment-specific modifications, QiNetix uses Windows registry keys or an appropriate file in the Unix and NetWare file systems.

This document describes such parameters and how to modify them. Note the following convention used in this document:

Windows

Back up the registry before you edit it. You must also understand how to restore the registry if a problem occurs.

WARNING: Using Registry Editor incorrectly can cause serious problems that may require a reinstall of the operating system. Neither Microsoft nor CommVault Systems can guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk.

Contact your software provider if you have any questions about these registry keys.

Unix/Macintosh

It is recommended that you make a backup copy of the appropriate .properties file, before editing it. This will help you to restore the appropriate parameters if a problem occurs.

NetWare

It is recommended that you make a backup copy of the appropriate GALAXY.INI file, before editing it. This will help you to restore the appropriate parameters if a problem occurs.


Registry Keys

The following section provides a list of some of the useful registry keys. If you know the name of the registry key, use the Search facility in your browser to locate the information. Given below is a list of links under which the registry keys are categorized:


1-Touch

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\FileSystemAgent\
Key SKIP_1TOUCH_BACKUP (optional)
Value Not applicable
Value Type (Windows only) DWORD Value
Valid Range Not applicable
Default Value None
Created In The Client computer in which the iDataAgent is installed
Description This key allows you to skip the backup of 1-Touch information during system state backups.
Applies To All Windows File System iDataAgents that support system state backups (not supported on Microsoft Windows 4.0).

 

Auxiliary Copy

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value AUXCOPY_NOT_PICK_NEW_BACKUPS (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 or 1
Default Value None
Created In CommServe computer
Description If the value set to 1, this registry key is enabled and auxiliary copy operations will not copy data protection operations that finish after the Auxiliary Copy operation has started. If the value is set to 0 or not set, then this registry key is disabled, and auxiliary copy operations will copy data protection operations that have finished after the auxiliary copy operation started.
Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value AUXCOPY_MARKCOPIED_MINUTES (optional)
Value Type (Windows only) DWORD Value
Valid Range 1 to infinite
Default Value None
Created In CommServe computer
Description Determines the time interval in which Auxiliary Copy operations update the status of jobs currently being copied. If the value of this registry key is not set, Auxiliary Copy operations update the CommServe database hourly.
Applies To CommServe

 

Data Classification

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Common\DataClassification\
Key FilterVolumes (optional)
Value Drive/volume name (letter)
Value Type (Windows only) String value
Valid Range Any valid volume location
Default Value None
Created In The computer in which the Data Classification Enabler and the DataMigrator Agent for Windows File System are installed
Description During an install of the Data Classification Enabler, a sqlite database (metafile) is created on the root of each NTFS volume. This key allows you to filter out a selected volume. For example, string value C:\ with value data C:\ filters out Volume C. Be sure to use a capital letter when specifying the drive/volume.
Applies To DataMigrator Agent for Windows File System with Data Classification

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Common\DataClassification\
Key DC_VOLUME_POLL_TIME (optional)
Value Number in milliseconds
Value Type (Windows only) DWORD value
Valid Range 1 to infinite (milliseconds)
Default Value 300000 milliseconds (decimal), 493e0 milliseconds (hexadecimal)
Created In The computer in which the Data Classification Enabler and the DataMigrator Agent for Windows File System are installed
Description This key allows you to modify the time interval used by Data Classification to check for new volumes and then start monitoring these volumes.
Applies To DataMigrator Agent for Windows File System with Data Classification

 

Disaster Recovery Backup

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value SetLifeSpanForFailedDR (optional)
Value Type (Windows only) DWORD Value
Valid Range number in Days
Default Value If it is not defined, the default is 90 days.
Created In CommServe computer
Description This key changes the default number of days partial disaster recovery backup sets will be kept when a disaster recovery backup is run. If this registry key is not used, the partial sets will be kept for 90 days and removed when the next disaster recovery backup is run.
Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value DisableActivityOnDbCorruption (optional)
Value Type (Windows only) DWORD Value
Valid Range any non-zero value
Default Value none
Created In CommServe computer
Description When this key is defined and the value is set to 0, CommServe job activities will NOT be disabled if during a Disaster Recovery Backup a database corruption is detected.  By default, when a Disaster Recovery Backup detects database corruption, CommServe job activities are disabled.
Applies To CommServe

 

Location  

Windows

HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\

Unix

Not Applicable

Netware

Not Applicable
Key LotusNotesDBAgent (standard)
Value nUSEBROWSETIMEFORDR (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 - 1 (0 = disabled, 1 = enabled)
Default Value If not defined, the default is 0.
Created In The Lotus Notes Database client computer in which the database disaster recovery operation will run, prior to executing the restore.
Description This key is used by the Lotus Notes Database iDataAgent Disaster Recovery process to recover a database from a log sequence prior to the current log sequence. When browsing back in time, the Agent will recover from an earlier log extent.
Applies To Lotus Notes Database iDataAgent

 

Job Management

Job History

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value jobHistoryLifeSpan (optional)
Value Type (Windows only) DWORD Value
Valid Range Number in Days
Default Value If it is not defined, the default is 90 days.
Created In CommServe computer
Description This key changes the default number of days job history will be kept when data aging is run. If this registry key is not used, job history will be kept for 90 days when data aging has been run. For more information, see Data Aging.
Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value archiverRestoreHistoryLifeSpan (optional)
Value Type (Windows only) DWORD Value
Valid Range Number in Days
Default Value If it is not defined, the default is infinite.
Created In CommServe computer
Description This key is used to set the number of days DataArchiver recovery job history will be kept when data aging is run. For more information on data aging, see Data Aging.
Applies To CommServe

 

Log Files

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key EventManager (standard)
Value NMaxLogFileSize (optional)
Value Type (Windows only) DWORD Value
Valid Range 5 through 50 MB
Default Value None
Created In CommServe computer
Description This key sets the maximum value of the size of the log files. If the file is greater than the value in the key, the file gets rolled over to <filename>_1.log.
Applies To CommServe

 

Job Controller

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value JMKillPreviousBackupJobForSameSubclient (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 - 1 (0 = disabled, 1 = enabled)
Default Value If not defined, the default is 0.
Created In CommServe computer
Description When enabled, the Job Manager will terminate a conflicting job, i.e., a new backup job that is initiated for the same subclient as a job that is currently running.

Note that the Job Manager will only terminate a conflicting job if the new backup job encompasses the earlier job and if the earlier started job has yet to transfer any data to media.  If these conditions exist, then the earlier job will be killed by the system and replaced by the newer job. To be more encompassing indicates that a FULL backup can kill jobs such as incrementals, differentials and other fulls; however, incrementals will not be able to kill fulls. If the current job has already started transferring data, then the normal queue rules for the new job will apply.

Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value JMRunningJobsHighWaterMark (optional)
Value Type (Windows only) DWORD Value
Valid Range 1 - infinite
Default Value If not defined, the default is 100
Created In CommServe computer
Description This key is used to set the maximum number of simultaneously running streams.   Many simultaneously running streams can cause the CommServe to overload. Therefore, the CommServe specifications should be taken into account when setting this value; however, it is recommended that the maximum not be set at more than 200.  The recommended minimum for this value is 5.
Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value JMRunningJobsLowWaterMark (optional)
Value Type (Windows only) DWORD Value
Valid Range 1 - any number less than the value of the high watermark
Default Value If not defined, the default is 0. (The value of 0 indicates that jobs will start immediately when the number of simultaneously running streams falls below the high watermark value.)
Created In CommServe computer
Description This key is used in conjunction with the high watermark value. When the high watermark value has been reached, the Job Manager will wait until the low watermark, if set, is reached before any new jobs are started. Therefore, the maximum value for this key must be less than the high watermark value.  The recommended minimum value is 3.
Applies To CommServe

 

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/MediaAgent/.properties
Key MediaAgent (standard)
Value UpdateJobManagerIntervalInSeconds (optional)
Value Type (Windows only) DWORD Value
Valid Range The time should be specified in seconds.
Default Value 5 minutes or when the chunk that was is created is closed.
Created in MediaAgent computer
Description This registry key is used to vary the interval at which jobs update the Job Controller about the amount of data that has been written. Changes to this key will take effect during subsequent write operations.

When established, this registry key will update the Job controller after the specified time.

Applies to Data Protection operations in the specific MediaAgent in which the registry key is established.

 

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/MediaAgent
Netware \<Galaxy Installation Directory>\Galaxy\GALAXY.INI <MediaAgent section>
Key MediaAgent (standard)
Value DMMBCHUNKSIZE (optional)
Value Type (Windows only) DWORD Value
Valid Range Chunk size specified in Megabytes.
Default Value This registry key takes precedence over all values established from the CommCell Console.

(The default values can be modified in the  Chunk Size tab of the Media Management Configuration. Chunk sizes can also be modified from the Data Path Properties dialog box available from the Data Paths tab of the Copy Properties dialog box.)

Created in MediaAgent computer
Description This key controls the chunk size for all data protection operations going to this MediaAgent. This registry key applies to all media types and application types and takes priority over the values established in the Advanced tab of Job Management dialog box. A lower value is recommended for frequent checks of slower data protection operations (especially when data is moving across a WAN link).
Applies to Data write operations in the specific MediaAgent in which the registry key is established.

 

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/OracleAgent/ .properties
Key OracleAgent (standard)
Value sALLOCATESTREAMSECS (optional)
Value Type (Windows only) String Value
Valid Range any non-zero value
Default Value 86400 seconds (if the registry key is not established)
Created in User-created in the computer in which the agent is installed.
Description This key determines the timeout, in seconds, that an Oracle third-party command line backup job will wait for a resource to allocate streams before the job fails. If a resource is not available after the specified number of seconds has elapsed, the backup job will fail. If this registry key is not entered, then the system will use a default timeout of 86400 seconds (i.e., 24 hours) before failing the backup job.
Applies to Oracle iDataAgent

 

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/OracleAgent/ .properties
Key OracleAgent (standard)
Value OraFailToQuit (optional)
Value Type (Windows only) String Value
Valid Range Y or N

Where:

Y prevents failover from occurring (i.e., does not look for another previous backup image);

N allows the system to fail over in the event a backup piece is inaccessible or corrupted.

Default Value When this key is not present, restore failover will be allowed for an Oracle 10g client.
Created in User-created in the computer in which the Oracle 10g iDataAgent is installed.
Description This key prevents restore failover from occurring for an Oracle 10g client when the key is created and its value is set to Y. It is useful to avoid job delays caused by the failover process, when the system attempts to locate another or previous image of a backup piece, which is inaccessible or corrupted, that is needed to complete the restore. It is also useful for avoiding the initiation of additional command line restore jobs for each failover attempt.

NOTE: When an Oracle 10g command line restore job fails and the OraFailToQuit registry key is not present or is set to a value of N, then a new command line job will be started for each failover attempt. To avoid this, you can set the value of this key to Y to prevent restore failover from occurring.

Applies to Oracle iDataAgent for Oracle 10g

 

Reports

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key CommServe (standard)
Value failedFilesSameColor (standard)
Value Type (Windows only) DWORD Value
Valid Range Nonzero = changes the failed file numbers color from red; zero = keep the failed file numbers color red
Default Value Zero
Created In CommServe computer
Description This key decides whether or not the failed file numbers of a report is shown in the color red. A nonzero value changes the color from red, a zero number keeps the color red.
Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\<ComputerName>
Key CommServe (standard)
Value failedFoldersSameColor (standard)
Value Type (Windows only) DWORD Value
Valid Range Nonzero = changes the failed folders number color from red; zero = keep the failed folders number color red
Default Value Zero
Created In CommServe computer
Description This key decides whether or not the failed folders number of a report is shown in the color red. A nonzero value changes the color from red, a zero number keeps the color red.
Applies To CommServe

 

Scheduling

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Key CommServe (standard)
Value schedWindow (optional)
Value Type (Windows only) DWORD Value
Valid Range 1 through 4320 minutes
Default Value 120 minutes
Created In CommServe computer
Description If a scheduled job was not initiated at the scheduled time, this registry key sets the maximum time past the scheduled time that a job will still be initiated.
Applies To CommServe

 

Space Check

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value bCHECK_GALAXY (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 or 1
Default Value 1
Created In All
Description If the value set to 1, the space requirements specified for the QiNetix directories such as the QiNetix installation directory, JobResults, or IndexCache will be checked. If the value is set to 0, the space requirements are not checked.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value bCHECK_SYSTEM (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 or 1
Default Value 1
Created In All
Description If the value set to 1, the space requirements specified for the system directories such as the %TEMP% directory for Windows computers and /tmp or /var directories for Unix computers will be checked. If the value is set to 0, the space requirements are not checked.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nSPACECHECK_INTERVAL_MINUTES (optional)
Value Type (Windows only) DWORD Value
Valid Range All
Default Value 360 minutes on the CommServe; 1440 minutes on remote machines.
Created In All
Description Specifies the interval (in minutes) that the system checks the following:
  • disk space for the software installation and system directories, and, for the Quick Recovery Agent and ContinuousDataReplicator, space on all volumes on the client computer
  • Updates available for download (CommServe only)
  • Service Packs available to be installed (Client or MediaAgent)
  • Upgrade required (Client or MediaAgent)

NOTES

  • When this registry key is created, or its value is changed, CVD must be recycled on the client before the new interval takes effect.
  • When the CVD service is recycled, the configured interval will be restarted from zero.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value bUSE_EVENTS (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 or 1
Default Value 1
Created In All
Description If the value set to 1, events are sent to the Event Viewer in the CommCell Console if any of the space limitations occur.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nINDEXCACHE_MAX (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value None
Created In MediaAgent
Description This registry key sets the threshold for the maximum number of bytes that should be consumed in the index cache directory, according to the value that is specified. If this value is set to 0, then the consumed space is not checked in this directory.
Applies To MediaAgent

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nGALAXY_MIN (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value 500 MB
Created In All
Description This registry key sets the threshold for the minimum number of bytes that should be available in the QiNetix Installation directory, according to the value that is specified. If this value is set to 0, then the available space is not checked in this directory.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nGALAXY_MAX (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value None
Created In All
Description This registry key sets the threshold for the maximum number of bytes that should be consumed in the QiNetix Installation directory, according to the value that is specified. If this value is set to 0, then the consumed space is not checked in this directory.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nJOBRESULTS_MAX (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value None
Created In Agent
Description This registry key sets the threshold for the maximum number of bytes that should be consumed in the JobResults directory, according to the value that is specified. If this value is set to 0 or the computer is not a client of the software, then the consumed space is not checked in this directory.
Applies To Agent

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nGALAXYTEMP_MIN (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value 500 MB
Created In All
Description This registry key sets the threshold for the minimum number of bytes that should be available in the QiNetix temp directory. If this value is set to 0, then the available space is not checked for this directory.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nGALAXYTEMP_MAX (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value None
Created In All
Description This registry key sets the threshold for the maximum number of bytes that should be consumed in the QiNetix temp directory of the software. If this value is set to 0, then the consumed space is not checked for this directory.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nSYSTEMP_MIN (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value 500 MB
Created In All
Description This registry key sets the threshold for the minimum number of bytes that should be available in the temporary directory of a system. If this value is set to 0, then the available space is not checked for these directories.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nSYSTEMP_MAX (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value None
Created In All
Description This registry key sets the threshold for the maximum number of bytes that should be consumed in the temporary directory of a system. If this value is set to 0, then the available space is not checked for these directories.
Applies To All

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nIDA_MIN (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value None
Created In Agent
Description This registry key sets the threshold for the minimum number of bytes that should be available in the QiNetix iDataAgent directory. If this value is set to 0, then the available space is not checked for this directory.
Applies To Agent

 

Location  
Windows HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)
Netware <Galaxy Installation Directory>\GALAXY.INI
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nIDA_MAX (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 to infinite
Default Value None
Created In Agent
Description This registry key sets the threshold for the maximum number of bytes that should be consumed in the QiNetix iDataAgent directory. If this value is set to 0, then the consumed space is not checked for this directory.
Applies To Agent

 

Location  
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nSYSVAR_MIN (optional)
Value Type (Windows only) DWORD Value
Valid Range None
Default Value 500 MB
Created In Unix computers
Description This registry key sets the threshold for the minimum number of bytes that should be available in the var directory on a Unix computer. If this value is set to 0, then the available space is not checked for this directory.
Applies To Unix computers

 

Location  
UNIX /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#
Key SpaceCheck
Value nSYSVAR_MAX (optional)
Value Type (Windows only) DWORD Value
Valid Range None
Default Value None
Created In Unix computers
Description This registry key sets the threshold for the maximum number of bytes that should be consumed in the var directory on a Unix computer. If this value is set to 0, then the consumed space is not checked for this directory.
Applies To Unix computers

 

Robust Network Layer

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\Session
Key CommServe (standard)
Value nRetryCount (optional)
Value Type (Windows only) DWORD Value
Valid Range None
Default Value 40
Created In CommServe computer
Description When retry logic is enabled, the value sets the number of times SendMessage is retried
Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\Session
Key CommServe (standard)
Value nRetryInterval (optional)
Value Type (Windows only) DWORD Value
Valid Range None
Default Value 30 seconds
Created In CommServe computer
Description When retry logic is enabled, the value sets the time interval between each retry of SendMessage.
Applies To CommServe

 

Location HKEY_LOCAL_MACHINE\Software\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\Session
Key CommServe (standard)
Value nEnableSendMessageRetry (optional)
Value Type (Windows only) DWORD Value
Valid Range 0 or 1
Default Value None
Created In CommServe computer
Description If the value set to 1, the retry logic in CvSession is enabled. If the value is set to 0, the retry logic in CvSession is disabled.
Applies To CommServe

 

Media Management

Drive Cleaning

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaManager (standard)
Value nAUTOMATICTAPECLEANINGINTERVALMIN (standard)
Value Type (Windows only) DWORD Value
Default Value 20 (minutes)
Created In CommServe computer
Description This key determines how often the Galaxy Media & Library Manager service on the CommServe should check for drives that require cleaning and start cleaning these drives, if the Enable Auto-Cleaning options are enabled in the Drive tab of the Library Properties dialog box.
Applies To All configured tape libraries in the CommCell.

 

Media

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaManager (standard)
Value nAUTOSTUCKTAPERECOVERYINTERVALMIN (standard)
Value Type (Windows only) DWORD Value
Default Value 20 (minutes)
Created In CommServe computer
Description This key determines how often the Galaxy Media & Library Manager service on the CommServe should try recovering media that may be stuck in a drive. (Media that are not cache mounted but remains in drive.), when the Enable Auto-Recovery option is enabled in the Drive tab of the Library Properties dialog box.
Applies To All configured libraries in the CommCell.

 

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/MediaAgent/.properties
Key MediaAgent (standard)
Value DataMoverMaxMountRetryValue (optional)
Value Type (Windows only) DWORD Value
Valid Range Integer (to indicate the number of retry attempts)
Created in MediaAgent computer
Description This key determines the number of times that QiNetix must retry to mount the media in the library for the job.

By default the registry key is not set and therefore retries are not attempted. The DataMoverMaxMountRetrySleepTime registry key must be created when you create this registry key.

Applies to Libraries configured in the MediaAgent in which the registry key is established.

 

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/MediaAgent/.properties
Key MediaAgent (standard)
Value DataMoverMaxMountRetrySleepTime (optional)
Value Type (Windows only) DWORD Value
Valid Range Number in minutes.
Created in MediaAgent computer
Description This key determines the amount of time that a job must wait before retrying a mount.

By default the registry key is not set. This key must be created when you create the DataMoverMaxMountRetryValue registry key.

Applies to Libraries configured in the MediaAgent in which the registry key is established.

 

Magnetic Mount Path

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key FilesystemAgent (standard)
Value nDoNotFilterGalaxyMagneticMountPaths (optional)
Value Type (Windows only) DWORD Value
Default Value None
Valid Range Set to any non-zero value to include magnetic mount paths in the backup.
Created in Computers where both MediaAgent and Windows File System iDataAgent is installed.
Description Normally, when a MediaAgent has a magnetic library, the mount paths (CV_MAGNETIC folder) are excluded from backup, when the Windows File System iDataAgent is installed on the computer. If this registry key is setup, the CV_MAGNETIC folder will be included.
Applies to Computers where both MediaAgent and Windows File System iDataAgent is installed and a mount path associated with the MediaAgent in the computer is configured.

 

Dynamic Mount Path

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaAgent (standard)
Value RegisterAndDetect (optional)
Value Type (Windows only) String
Default Value N/A
Created in MediaAgent computer
Description This key must be created and the value set to Y before running a detection using Volume Explorer for configuring the disk as a dynamic mount path. The presence of this  key results in the correct detection scheme for uniquely identifying a specific disk shared between multiple MediaAgents. As the detection process uses SCSI-3 persistent reservation,  it is a pre-condition that these disks should support SCSI-3 persistent reservation.
Applies to MediaAgent computers in which the dynamic mount path is shared.

 

Media and Drive Reservation

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaManager (standard)
Value nRESOURCERELEASEINTERVALMIN (standard)
Value Type (Windows only) DWORD Value
Default Value 1440 (minutes)
Created in CommServe computer
Description This key determines how often the Galaxy Media & Library Manager service on the CommServe cleans up any media and drive reservation that is held by a job which failed to release the resource when it was abruptly terminated.
Applies to All libraries in the CommCell.

 

Blind Library

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaManager (standard)
Value nBlindInventoryNoOfDrivesToBeUsed (optional)
Value Type (Windows only) DWORD Value
Valid Range Number of drives as a numeric value.
Default Value By default the registry key is not set and therefore all the drives will be used by the inventory operation in a blind library.
Created in CommServe computer
Description This key is used to specify the maximum number of drives that can be used during a blind library inventory operation.
Applies to All MediaAgents with blind libraries in the CommCell

 

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaManager (standard)
Value nBlindReserveRetryTime (optional)
Value Type (Windows only) DWORD Value
Valid Range Number in seconds.
Default Value By default the time interval used by a blind library inventory operation is 120 seconds.
Created in CommServe computer
Description This key is used to vary the default value of the time interval when a blind library inventory retries drive reservation.
Applies to All MediaAgents with blind libraries in the CommCell

 

SAN Path Report

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaAgent (standard)
Value DataPathUpdateIntervalMinutes (optional)
Value Type (Windows only) DWORD Value
Valid Range Number in minutes 
Created in MediaAgent computer
Description This key is used to enable and control the time interval after which successive SAN DATA PATH updates can be run on a MediaAgent. This value has to be positive number for the SAN data path updates to work properly.
Applies to MediaAgent attached to devices in the SAN environment.

 

Index Check Pointing

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Key MediaAgent (standard)
Value sINDEXCHECKPOINT (optional)
Value Type (Windows only) String Value
Valid Range Y or Yes (not case sensitive)
Created in MediaAgent computer
Description This key is used to enable the index check pointing feature.
Applies to MediaAgent.

 

Dual HBA Support

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/MediaAgent/.properties
NetWare In Galaxy.ini add the following entry in the [MediaAgent] section:

DoFailoverDrivePool=<value>

Key
 
CommServe MediaManager (standard)
MediaAgent MediaAgent (standard)
Value DoFailoverDrivePool (optional)
Value Type (Windows only) DWORD Value
Valid Range 1 or 0
Created in CommServe and MediaAgent computers
Description This key is used to enable the dual HBA support.

A value of 1 enables support for dual HBA.

Applies to MediaAgent

 

MediaAgent

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/MediaAgent/.properties
NetWare In Galaxy.ini add the following entry in the [MediaAgent] section:

nDisabledDriveDetectIntervalMin= <value>

Key MediaAgent (standard)
Value nDisabledDriveDetectIntervalMin (optional)
Value Type (Windows only) DWORD Value
Valid Range Number in minutes
Created in MediaAgent computer
Description This key will override the interval value between two device detections established in the MediaAgent Properties.

The minimum value for this key should be 60.

If this key is not present the interval value established in the MediaAgent properties for SCSI update interval is used.

If this key is present and the value is 0, then detection for disabled drives are prevented.

Applies to Drives configured in the MediaAgent in which the registry key is established.

 

Location  
Windows HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\ControlSet00#(<ComputerName>)\
Unix /etc/CommVaultRegistry/Galaxy/PlatformInformation/ControlSet00#(<ComputerName>)/MediaAgent/.properties
NetWare In Galaxy.ini add the following entry in the [MediaAgent] section:

nDisabledDriveMaxDetectionRetryHours= <value>

Key MediaAgent (standard)
Value nDisabledDriveMaxDetectionRetryHours (optional)
Value Type (Windows only) DWORD Value
Valid Range Number in hours
Created in MediaAgent computer
Description This key will override the default period of time, i.e., 7 days, for which the detection of the disabled drives have to be retried.

After this specified Maximum Retry period, the drive controller will be marked as enabled even if the drive is not accessible.

Applies to Drives configured in the MediaAgent in which the registry key is established.

 

Exchange 2000 and 2003 Mailbox

Location HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Platform Information\<ServerName>\MSExchangeMBAgent\
Key ADServerList (optional)
Value sServerName (optional)
Value Type (Windows only) String Value
Valid Range Exchange 2000 or 2003 Server Name
Created in This key needs to be set up on the Exchange Server if the user’s mailboxes and accounts reside in a non-default domain or multiple domains. This is often the case when child domains are in use.
Description In this case a key called ADServerList should be setup under MSExchangeMBAgent.

This key can be setup in two ways, of which the first method is recommended:

1) Add one string value for each domain. For example if there is a child domain child1.example.com with users, and also users in the top level domain example.com, then both these domains should be specified as string values under this key. The value names are not important.

2) If the above method fails, then another method is to list the hostnames of the AD Servers or their IP addresses as string values under this key. Again, the value names are not important.

Applies To Exchange 2000 and 2003 Mailbox iDataAgents

DataMigrator for Exchange 2000 and 2003 Agents

DataArchiver for Exchange 2000 and 2003 Agents

 

DataMigrator Outlook Add-in Install

Location HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Outlook\Addins\
Key Galaxy.Ex2KMBDM.CVEAAddin (optional)
Value UseOSLocale (optional)
Value Type (Windows only) DWORD Value

Valid Range

0 or 1
Default Value None
Created in Computer that the DataMigrator Outlook Add-In component is installed on.
Description This registry key can be modified after installing the DataMigrator Outlook Add-In in order to change the default language setting of the Outlook Add-In the use the same language as the operating system.
Value Use OS Language Setting Use Outlook Language Setting
none No Yes
0 No