DS-System Help : Configuring the DS-System : Configuring the advanced settings
 
Configuring the advanced settings
By default, the DS-System is optimized for maximum performance. However, advanced configurations are available for users who want to change the DS-System behavior.
NOTE:  Some of these parameters are used to apply a consistent setting across all nodes in an N+1 configuration because individual nodes might have different configurations in the dssys.cfg file. For more information see, “Updating the DS-System configuration file parameters”.
To configure the advanced settings:
1. On the Setup menu, click Advanced Configuration.
2. To change the value of an advanced configuration parameter, select the parameter, and then click Edit
3. In the Value box, enter a value, and then click OK.
4. To update the list, click Refresh.
5. Click Close.
The following is a list of the advanced configuration parameters:
 
Table 2 Advanced configuration parameters
Parameter
Description / Values
AllowStorageLock
Locks the online storage for third-party snapshots.
0 (Off) = (default)
1 (On) = DS-System will display a Lock online storage for snapshot option in the System Activities Administration dialog box.
Note: Requires the DS-System to be restarted.
AllowUnencryptedConnections
DS-System accepts unencrypted connections from the DS-Operator.
0 = Off
1 = On (default)
AutoUpgrade
Method by which DS-Client upgrades are handled.
0 = Disables automatic upgrades.
1 = Enables automatic upgrades.
CleanActivityLog
Number of months after which Activity Logs are automatically cleaned by the delete logs process.
Default: 12
Range: 0-360 (0 = disabled)
CleanAudit
Number of months after which audit trail logs are automatically cleaned by the delete logs process.
Default: 0
Range: 0-360 (0 = disabled)
CleanClientEvent
Number of months after which client Event Logs are automatically cleaned by the delete logs process.
Default: 6
Range: 0-360 (0 = disabled)
CleanClusterEvent
Number of months after which N+1 Event Logs are automatically cleaned by the delete logs process.
Default: 12
Range: 0-360 (0 = disabled)
CleanDeleteLogs
Number of months after which GDPR delete logs are automatically cleaned by the delete logs process.
Default: 1
Range: 0-360 (0 = disabled)
CleanEventLog
Number of months after which Event Logs are automatically cleaned by the delete logs process.
Default: 12
Range: 0-360 (0 = disabled)
CleanHealingHistory
Number of months after which healing history logs are automatically cleaned by the delete logs process.
Default: 12
Range: 0-360 (0 = disabled)
CleanLibLink
DS-System cleans orphaned library links.
0 = Off (default)
1 = On
CleanLoadSummary
Number of months after which load summary logs are automatically cleaned by the delete logs process.
Default: 12
Range: 0-360 (0 = disabled)
CleanStorageHistory
Number of months after which storage history logs are automatically cleaned by the delete logs process.
Default: 12
Range: 0-360 (0 = disabled)
CleanStorageSummary
Number of months after which storage summary logs are automatically cleaned by the delete logs process.
Default: 12
Range: 0-360 (0 = disabled)
ClientDBDumpDays
Number of days the DS-System will retain DS-Client database dumps.
Default: 2
Range: 1-10
ClientDeleteThread
Number of processing threads that should be started for the delete DS-Client process. This parameter is applicable if a DS-Client is being moved to the trash directory.
Default: 2
Range: 1-100
DBDumpDays
Number of days for which database dumps must be retained in the primary storage dump sub-folder.
Default: 2
Range: 1-10,000
DBDumpEnd
Time when the database backup should end. If this value is less than the DBDumpStart value, the database backup is completed the next day.
For Windows:
Default: 23
Range: 0-23
For Linux:
Default: 17
Range: 0-23
DBDumpMethod
DS-System performs database backup during the dump window created between DBDumpStart and DBDumpEnd.
For Windows:
0 = differential, DS-System performs a full database dump every day and a differential backup of its database every hour.
1 = full, DS-System performs a full database dump once a day and no differential backups.
For Linux:
0 = custom, DS-System dumps the database in a compressed TAR format.
1 = tar, DS-System dumps the database in an uncompressed TAR format.
2 = plain text, DS-System dumps the database in plain text format.
DBDumpPath
Destination folder where the DS-System database dump will be saved. The SQL service account must have read/write permission for the dump location.
DBDumpStart
The hour at which the database backup window will start. For differential backups, the start time is also when the full database dump occurs.
For Windows:
Default: 0
Range: 0-23
For Linux:
Default: 8
Range: 0-23
DefaultHardwareResetTimer
Amount of time (in minutes) for the DS-Client to connect and perform a hardware registration activity.
Default: 5
Range: 1-10,080
DefaultTrashDays
Minimum number of days that a file must stay in the trash folder of an extensible storage location before it is removed by the empty trash process.
Default: 7
Range: 0-99
If you specify a value of 0, the data will not be permanently deleted until midnight the following day.
DeltaCheckOption
Whether validation of delta reconstruction indexes must be performed during the Autonomic Healing process.
Default: 0
Range: 0-2
0 = validate delta index only
1 = skip validation of delta indexes
2 = validate delta index and check delta block checksum
DirectorMode (N+1 specific)
Specifies how the DS-Directory operates in an N+1 DS-System.
0 = Dedicated DS-Director, will not accept DS-Client connections
1 = DS-Director works as a normal DS-System to accept DS-Client connections
Note: Requires the DS-System to be restarted.
DirScanLimit
Number of directories that can be opened at the same time by a DS-Client synchronization process to limit DS-System I/O.
Default: 5
Range: 1-1000
Note: Requires the DS-System to be restarted.
DirStoreSafeMode
Determines how the DS-System saves directory metadata. If the parameter is enabled, DS-System saves the directory descriptor information as follows:
Individual _dirdesc files in the corresponding directories where the backed up data appears.
Consolidated _dir_store file from all directories in a backup.
 
If the parameter is disabled, DS-System saves the directory descriptor information only in the consolidated _dir_store file from all directories.
 
There are three levels of _dirdesc files:
Backup set - Contains information about the backup.
Share - Contains information about the share.
Directory - Contains information about the directory.
 
If a _dirdesc file is corrupted or missing, the following actions are taken by the DS-System:
When autonomic healing and System Admin detect a _dirdesc file corruption, an error is reported in the DS-System Event Log for the activity and the directory is skipped by the autonomic healing or System Admin process.
When backup activities are running, the _dirdesc file is automatically overwritten without checking its validity.
When synchronization activities are running, the corrupted or missing _dirdesc file is replaced with information received from the DS-Client. If the DS-Client cannot provide this information, the DS-System creates a _dirdesc file with alternate file information in the form: RECOVER_DIR_<dir_id>
0 = Off
1 = On (default)
DirStoreVacuum
Threshold percentage that must be reached before the DS-System cleans up empty space in the _dir_store file for backups.
Default: 5 (e.g. 5%)
Range: 0-100
DisasterRecoveryMode
Mode in which DS-System should run - normal or disaster recovery.
Important: This parameter should be used only in case of an actual failure in the DS-System’s extensible storage.
0 = Off, Run DS-System in normal mode (default)
1 = On, Run DS-System in disaster recovery mode
Note: Requires the DS-System to be restarted.
DSSysGroup
Configure DS-System groups for replication.
0 = Off
1 = On
Note: Requires the DS-System to be restarted.
EmerPMFreq
Frequency (in hours) at which emergency messages will be written to the Event Log.
Default: 1
Range: 1-24
EmptyTrashThread
Number of additional threads that should be used to perform the empty trash process.
Default: 1
Range: 0-99
EmptyTrashTime
Start time (hour of day) for the empty trash process.
Default: 6
Range: 0-23
ExcludeRecycleDelta
To include or exclude recycled delta generations from calculations of stored size.
0 (Off) = DS-System includes recycled delta generations.
1 (On) = DS-System excludes recycled delta generations.
Note: Requires the DS-System to be restarted.
FailBackupOnBLMError
Select action to be taken if the movement of data to the BLM Archiver fails for backups configured with the BLM (Infinite Generations) option.
0 (Off) = The backup ignores the BLM error.
1 (On) = The backup of that specific generation will fail.
FileStoreCache
Number of consolidated FileStores that can be open at the same time. This applies to the backup, disc/tape write-to-buffer, autonomic healing, BLM Archiver, and replication processes.
Default: 2
Range: 0-100
Note: 0 means only the current FileStore is allowed to be open. Higher values require more system resources.
FileStoreVacuum
The percentage of the total number of deleted files in the FileStore that must be reached before System Admin triggers a Vacuum FileStore process. Each FileStore (in each directory) is assessed separately.
Default: 5 (i.e. 5%)
Range: 0-100
FileWriteTrunkSize
Volume of data that is cached for write operations to the online storage. This parameter allows you to optimize write performance.
Default: 32 (KB)
FixDeltaChain
Fix a long delta chain during the optimization process if the number of deltas for a file is longer than the value for the Default delta chain length parameter. This applies only to ‘on-demand’ master /delta optimizations triggered from DS-Operator.
0 = Off
1 = On
GrpEncrypt
To use encrypted communication for a DS-System group. All DS-Systems in the group must have the same setting:
0 = Off
1 = On
GrpPort
Specifies the DS-System group communication port.
Default: 4409
Note: Requires the DS-System to be restarted.
GrpSerialCode
Specifies the DS-System group serial code.
Default: 0
Range: 0-2,147,483,647
HealingProcess
Number of autonomic healing processes that start simultaneously.
Default: 3
Range: 1-256
HealingThreads
Number of threads that can be used for the autonomic healing process.
Default: 1
Range: 1-32
LibCreateCount
Specifies the number of copies of the same content that must be backed up before a library file is created.
Default: 3
Range: 2-10
Note: Requires the DS-System to be restarted.
LicExpireNotif
Number of days before the DS-System license expires for DS-System to send a notification.
Default: 7
Range: 1-100
LicNotifFreq
Notification frequency (in hours) before the license expires (LicExpireNotif) and license capacity (LicStorageNotif) parameters.
Default: 1
Range: 1-24
LicStorageNotif
Specifies the license storage capacity warning level percentage. When available capacity falls below this amount, DS-System sends a notification.
Default: 1000 (e.g. 10% left / 90% used)
Range: 1-10000, default is 1000
MaxBlockSize
Maximum block size (in bytes) when sending messages.
Default: 0
Range: 0-65,536 (0 = no maximum)
MaxCommunicationManagersPerProcessingThread
Maximum number of communication managers per processing thread.
Default: 10
Range: 1-10
MaxCommunicationManagersPerThread
Maximum number of communication managers per thread.
Default: 10
Range: 1-10
MaxPrivateDays
Maximum number of days to keep potential libraries in the DS-System database.
Default: 365
Range: 60-10,000
MaxPrivateItems
Maximum number of potential libraries to keep in the DS-System database.
Default: 1,000,000
Range: 10,000-1,000,000,000
MaxReceivingQueueSize
Maximum number of pending requests in the receiving queue.
Default: 20
Range: 20-1024
Note: Requires the DS-System to be restarted.
MaxSendingQueueSize
Maximum number of pending requests in the queue.
Default: 20
Range: 20-1024
Note: Requires the DS-System to be restarted.
MemEmerLevel
Critical level of free memory at which an emergency notification is sent.
Default: 0 (no check performed)
Range: 0-10,000
MemWarnLevel
Critical level of free memory at which a notification is sent.
Default: 0 (no check performed)
Range: 0-10,000
MinLibFileSize
Minimum size (in KB) for library files on the DS-System. Potential library files smaller than this value will be ignored by the common file elimination process.
Default: 32
Range: 32-102,400
MLRCache
Number of consolidated FileStores that can be open at the same time. This applies only to backup processes for email level backups.
Default: 10
Range: 0-100
MultiStorage
Specifies if multiple storage locations can be configured on the same volume.
0 (Off) = (Default) Do not allow multiple storage locations on the same volume.
1 (On) = Allow multiple storage locations on the same volume.
NativeSize
Specifies if the DS-System will save the native size information in its “dsset_size” table, which can only be viewed if the database is queried directly.
Default: 0
Range: 0-2
0 — Disabled. DS-Client will not send native size data to DS-System.
1 — Enabled. DS-Client will send native size.
2 — Enabled. DS-Client will send native size.
OLEmerLevel
Emergency notification level for the available space in the online storage based on the following space events configured for extensible storage locations:
Physical space is represented by the Disk Space column.
Logical space is represented by the Used Size column.
Default: 200 (2%)
Range: 1-10,000
OLStopLevel
Stop notification level for the available space in the online storage based on the following space events configured for extensible storage locations:
Physical space is represented by the Disk Space column.
Logical space is represented by the Used Size column. Default: 50 (0.5%)
Range: 1-10,000
OLWarnLevel
Warning notification level for the available space in the online storage based on the following space events configured for extensible storage locations:
Physical space is represented by the Disk Space column.
Logical space is represented by the Used Size column.
Default: 500 (5%)
Range: 1-10,000
PubLibSwitch
Global public library switch.
0 (Off) = No public libraries.
1 (On) = Allows public libraries (default).
ReadOnly
Read-only DS-System.
0 (Off) = Normal DS-System (default)
1 (On) = DS-System will run with read-only storage. It does not allow or perform any activities that alter the storage.
Note: Requires the DS-System to be restarted.
RecoveryLibThreads
Number of threads used to recover libraries during DS-System disaster recovery if the DisasterRecoveryMode parameter is set to 1.
Default: 4
Range: 1-16
RecoveryProcess
The number of disaster recovery processes that can start on each DS-System node at the same time. When the disaster recovery process finishes processing a backup, the DS-Client must perform a DS-System based synchronization. Weekly Admin or scheduled backups initiate this synchronization automatically.
Default: 4
Range: 1-100
RecoveryValidateFile
Disaster recovery will perform file level validations which will significantly affect performance. It is recommended that you perform autonomic healing instead because it has more advanced file level validations.
0 = Off
1 = On
RecycleSwitch
Enables delta recycling which affects the frequency of master file reconstructions.
0 = Off, backups are slower due to the greater number of reconstructions.
1 = On, backups are faster at the expense of storage.
RemoteVDRMaxSched
Maximum number of scheduled Remote DS-VDR activities that are allowed to run concurrently.
Default: 10
Range: 0-99
RemoteVDRPowerOnPrioDelayDef
Default delay time (in seconds) for the Power On option if multiple virtual machines are configured for Remote DS-VDR.
Default: 60
Range: 0-3600
RemoteVDRRetry
Number of times DS-System will attempt to connect to the Remote DS-VDR Tool.
Default: 5
Range: 0-99
RemoteVDRWait
Amount of time (in minutes) that the DS-System will wait before retrying to connect to the Remote DS-VDR Tool.
Default: 5
Range: 0-99
RepairFromReplication
How the DS-System will handle corrupted generations discovered by the autonomic healing, System Admin, validation, or system validation processes.
0 = Off - If a corrupted generation is found, the process will delete the file without trying to recover it from the replication DS-System.
1 = On (default)
ReplicationCheck
Interval (in hours) at which a replication check is performed for shared DS-Clients.
Default: 6
Range: 0-360 (0 = disabled)
ReplicationDelThreads
Number of delete threads that should be started for replication.
Default: 2
Range: 1-100
ReplicationProcess
Maximum number of concurrent replication processes on each node configurable at DS-System level for each DS-System in a replication group.
Default: 4
Range: 0-100
ReplicationRecvThreads
Number of receive threads that should be started for replication:
Default: 4
Range: 1-100
ReplicationSendThreads
Number of send threads that should be started for replication.
Default: 2
Range: 1-100
SkipDBDump
Specifies if the DS-System will skip the database backup (dump).
0 (Off) = (default) The DS-System database is backed up (dumped) based on the DBDumpMethod, DBDumpStart, and DBDumpEnd.
1 (On) = Skips the database backup (dump).
SmallFileCount
Threshold to consolidate small files (non-master/delta) in the same online storage directory into one large FileStore during System Admin.
Default: 10
Range: 0-10,000
Note: 0 means all small files in a directory will be consolidated to the FileStore.
SMTPDebug
Specifies if debug information for the SMTP send message process is logged. This debug information is saved to the DS-System Event Log.
0 = Off (default)
1 = On
SyncDRScan
Specifies if a disaster recovery scan is performed during synchronization.
0 (Off) = (default) Disables the scan unless an entire backup is missing on the DS-System.
1 (On) = Forces a scan during any backup synchronization from DS-Client which is more secure.
SysAdminProcess
Number of System Admin processes that can start on each DS-System node at the same time.
Default: 1
Range: 1-20
SysAdminThreads
Number of threads that can be used for the System Admin process.
Default: 4
Range: 1-32
TcpBufferSize
Buffer size for communication (in bytes).
Default: 34,752 (Windows), 0 (Linux)
Range: 0-34,752,000
TcpNoDelay
Disables or enables the TCP option TCP_NODELAY. This can be useful in a high latency TCP environment where the round-trip time for messages is slow.
0 = Off
1 = On (default)
TrashSwitch
Configures the trash feature on the DS-System.
0 = Off, data deleted from DS-System online storage is permanently removed.
1 = On (default), processes that delete data from the DS-System will move deleted files to the corresponding extensible storage location's trash folder.
UseClientSNAP
Uses a third party snapshot for DS-Client BLM point-in-time copy requests to unlock a backup as quickly as possible.
0 (Off) = DS-System locks a backup for the duration of the BLM Archiving activity.
1 (On) = DS-System integrates with third-party software to create a snapshot of the required directories.
UseSnapshot
Uses a storage snapshot for DS-System snapshot-capable processes.
0 = Off (default)
1 = On
VADPCfgDevIgnoreList
Specifies the VM configuration parameters to ignore, such as device keys, during an incremental virtual machine restore via Remote DS-VDR. This parameter applies only to VMware vCenter Server backups. Device keys are listed in regular expressions.
VADPCfgIgnoreList
Specifies the VM configuration parameters to ignore, during an incremental virtual machine restore via Remote DS-VDR. This parameter applies only to VMware vCenter Server backups. Root keys are listed in regular expressions.
WarnPMFreq
Specifies the warning message frequency (in hours).
Default: 4
Range: 1-24