Configuring the DS-Client : Configuring the DS-Client settings : Configuring the advanced settings : Miscellaneous parameters (Windows)
 
Miscellaneous parameters (Windows)
 
Parameter
Description
AllowAutoConfig
Allows DS-Client to apply auto-configuration from the file config-update.xml.
Yes = On (Default)
No = Off
AllowAutoUpgrade
Allows auto-upgrade of DS-Client from DS-System when the versions do not match.
Yes = On (Default)
No = Off
AllowLocal
If set to Yes, it allows execution of local commands during Pre/Post activities. You must be an administrator and have this option enabled to enable the Pre/Post activities. If this parameter is changed, it takes effect next time the DS-User connects to DS-Client Service.
No = Off (Default)
Yes = On
AllowScheduledBackupCheckSignature
Configures scheduled backups to use the Verify signature for unchanged files feature.
By default, this option is turned off. If this parameter is set to Yes, scheduled backups will verify the signatures of unchanged files on the backup source.
 
Note: Turning this option on can have significant implications on the performance of the DS-Client.
No = Off (Default)
Yes = On
BrowseCheckSQLInstances
Detects Microsoft SQL Server instances when browsing domains and workgroups.
No = Off (Default)
Yes = On
DBQueryDefaultTimeout
Sets the default database query timeout (in seconds). A value of 0 means unlimited timeout.
Default: 500
Range: 0 to 65535
DBQueryTimeout
Sets the longest database query timeout period (in hours). This only applies to time consuming database queries known by the DS-Client. If the database query takes longer than this value, it is aborted by the DS-Client.
A value of 0 means unlimited timeout.
Default: 18
Range: 0 to 19
DebugMessage
Sets the detail level of error messages reported in the DS-Client event log.
0 = Standard level of error-message reporting. (Default)
1 = Additional detailed log information is reported, such as database errors that are appended with the SQL statement.
2 (or any higher number) = Same behavior as “1”, with additional debug information in a DS-Client debug log file (dsclient.exe.dbg.log located in the DS-Client installation directory). This option is meant for debug situations only.
Note: For Grid DS-Clients, this parameter can be applied globally or to individual leaf nodes.
DefaultLocalTrashKeepDays
Default period (in days) to keep data in the Local-Only trash. This applies to all of the DS-Client’s Local-Only paths.
Default: 7
Range: 1-999
ExchangeOnlineBackupBatchSize
Maximum number of items that a batch should contain during backup of Cloud (Microsoft Office 365) Exchange and Microsoft Exchange Server EWS backup sets.
Default: 32
Range: 1-40
 
When set to 1, DS-Client downloads data from the source one item at a time. When set to 2 or greater, batch downloading is enabled, and DS-Client downloads data one batch at a time from the source as soon as one of the following occurs:
DS-Client has filled up a batch to the number of items specified by this parameter.
DS-Client is timed out of the duration specified in the parameter ExchangeOnlineBackupBatchTimeout when DS-Client is unable to fill up a batch fully. This can happen when there are not enough items remaining to back up on the source.
ExchangeOnlineBackupBatchTimeout
Wait time (in seconds) before DS-Client must download a batch from a Cloud source during the backup of Exchange data for Cloud (Microsoft Office 365) and Microsoft Exchange Server EWS backup sets.
Default: 60
Range: 0-3600
ExchangeOnlineBackupExtendedMetadata
Backup from the Cloud (Microsoft Office 365) Exchange backup sets will include the extended metadata (“To”, “From”, “Cc”, “Bcc”) to be able to search the item list on restore, delete, etc. If this is on, it will slow down the browse listing and the backup process.
No = Off (Default)
Yes = On
ExchangeOnlineEnableLogs
Activates logging for the Exchange Online plug-in (Microsoft Office 365 backup sets). The default path is:
<DS-Client Installation Path>\asigra_pluginlog
No = Off (Default)
Yes = On
ExchangeOnlineExcludeGroupMailboxes
DS-Client verifies each mailbox on listing to prevent display of Exchange Online group mailboxes. Group mailboxes are invalid backup items that will cause errors during backup if included in a Backup from the Cloud (Microsoft Office 365) Exchange backup set.
If on, the listing can be considerably slower because DS-Client must verify each mailbox before displaying the filtered result.
No = Off (Default)
Yes = On
ExchangeOnlineFilterListingBySet
When on, this improves the performance of incremental backups for Cloud (Microsoft Office 365) and Microsoft Exchange Server EWS backup sets by using the last successful backup date and time as the backup filter instead of the last modified date and time of an individual item.
 
To back up items that have been created or modified before the last successful backup (for example, after you have performed a selective delete), turn this parameter off.
No = Off (Default)
Yes = On
ExchangeOnlineListingPageSize
Number of items per listing page for Cloud (Microsoft Office 365) and Microsoft Exchange Server EWS backup sets.
Default: 1000
Range: 100-1000
ExchangeOnlineOutlookConnectionTimeout
Timeout (in seconds) for the DS-Client’s connection attempt to Microsoft Outlook. This applies during a restore activity that archives Microsoft Exchange data to a PST file on the DS-Client local disk. It applies only to Backup from the Cloud (Microsoft Office 365) and Microsoft Exchange Server EWS backup sets.
Default: 120
Range: 1-600
ForceBackupCheckSignature
Forces all applicable backup sets to check signature for unchanged files. The check will be performed once during the next backup of each backup set. This setting applies only once. This means, as soon as you select Yes and apply, it will immediately take effect and the value is changed to No again.
No = Off (Default)
Yes = On
GAppsBackupExtendedMetadata
Backup G Suite extended metadata for item list filtering. If yes, this can increase backup time significantly.
No = Off (Default)
Yes = On
GAppsBackupReadTimeout
Minimum timeout (in seconds) for backup read requests.
Default: 1
Range: 0-4
GAppsMaxJavaPluginThreads
Maximum number of threads for the G Suite plug-in.
Default: 64
Range: 0-2,147,483,647
GAppsPartialDownload
Downloads large G Suite drive files in smaller 1MB blocks to reduce memory usage on DS-Client. If ON, the trade-off is 2-3 times slower performance than if this parameter off.
No = Off (Default)
Yes = On
GAppsRequestRetry
If one G Suite item fails to be backed up or restored, how many times to retry.
Default: 7
Range: 0-9
GAppsRestoreCompleteTimeout
Minimum timeout for restore of any single G Suite item. (Increases automatically for files over 100MB.)
Default: 300 (seconds)
Range: 0-3600
InstantRecoverySyncCheckingInterval
After performing an instant recovery, DS-Client waits this amount of time (in minutes) before performing an internal synchronization of data in the backup set's instant recovery folder. This is also the delay time before retrying if the Instant Recovery Synchronization process fails or is interrupted.
Default: 30
Range: 1-1440
InstantRecoverySyncRetryTimes
Number of times the Windows DS-Client attempts an Instant Recovery Synchronization based on the InstantRecoverySyncCheckingInterval parameter.
Default: 10
Range: 0-1000
LocalDriveAllowed
This parameter value will configure the Local Drive Filter Flag for backup. This controls the drives available for backup in the New Backup Set Wizard (applicable only to File system & Permissions only backup sets).
 
The decimal value is converted to binary to determine if a drive is allowed (1 means allowed, 0 means disabled).
For example, to allow selection of only drives ‘C’ and ‘E’, use the value ‘20’.
... . . . . 2 0 [decimal value]
... . 1 0 1 0 0 [binary]
... F E D C B A [drive letter map]
The binary representation of “20” matches bit0 for 'A:' disabled, bit1 for 'B:' disabled, bit2 on - 'C:' allowed, etc.
Default: -1
A value of -1 allows all the available local drives.
Note: For Grid DS-Client, this parameter has no effect.
LogArchivePath
Path where detailed logs of DS-Client activities are stored as text files. Each backup set has its own numbered sub-folder.
Default: <DS-Client installation folder>\asigra_archivlog
Any path where the DS-Client can write data is valid.
Note: For Grid DS-Clients, enter a UNC path that is accessible from all nodes of the Grid. Doing so ensures that all detailed logs are located in a common and accessible location.
MaxErrors
Sets the default “Stop on errors” value that appears when you create a new backup set (in the New Backup Set Wizard’s Options Tab).
Default: 0 (no limit)
Range: 0 to 9999
MaxNonFullDumps
For all backup sets that define a database backup policy in the Set Properties > Options tab. For more information on Database Backup Policy options, see the Knowledge Base article in “Backup / restore of Microsoft SQL Server (all versions)”.
Default maximum number of times a full dump of the database can be skipped in favor of a differential or incremental dump. Once this number is reached, the next backup forces a full dump of the database.
Default: 120
Range: 2 to 1000
Multi-Tenant
Enables the Multi-Tenant feature.
No = Off (Default)
Yes = On
Office365RequestRetry
Maximum number of retries when backing up or restoring Exchange or SharePoint data in a Cloud (Microsoft Office 365) backup set.
Default: 9
Range: 0-20
Office365RequestTimeout
API request timeout duration (in seconds) for Backup from the Cloud (Microsoft Office 365) backup sets.
Default: 600
Range: 0-3,600
PluginLogKeepDays
How many days to keep the Java plug-in log files for “Backup from the Cloud” backup sets (Salesforce.com, G Suite, and Microsoft Office 365).
Default: 7
Range: 1-9999
ReadOnlyUpgradeInterval
Interval (in minutes) at which DS-Client checks for an upgrade package from DS-System if it is running in “Read-Only” (Stand By) mode (no backup or restore allowed).
Default: 5
Range: 1-60
RemoteExecutionTimeout
Timeout period (in minutes) for Remote Command Execution during Pre/Post activities.
Default: 60
Range: 1 to 1440
RestoreTargetProvision
Path where the DS-Client can access the integration DLL file for automatic restore target provisioning.
Default: None
Note: This parameter requires the DS-Client to restart before taking effect.
ScheduleMiss
Number of hours after the start time of a missed schedule, that DS-Client continues to attempt to trigger it. For example, if set to 6 and a schedule from 12:00 PM to 20:00 PM is missed, the schedule will still be triggered as long as it is within 6 hours after the scheduled start time and before the scheduled end time.
Default: 6
Range: 1 to 16
SecurityDll
Path to a third-party security DLL to secure the communication.
Default: None
Note: For Grid DS-Clients, this parameter can be applied globally or to individual leaf nodes.
SharePointOnlineBackupBatchSize
Maximum number of items that a batch should contain during backup of SharePoint data for Cloud (Microsoft Office 365) backup sets.
Default: 1
Range: 1 to 10
 
When set to 1, DS-Client downloads data from the source one item at a time.
 
When set to 2 or greater, DS-Client downloads data one batch at a time from the source as soon as one of the following occurs:
DS-Client has filled up a batch to the number of items specified by this parameter.
DS-Client is timed out of the duration specified in the parameter SharePointOnlineBackupBatchTimeout when DS-Client is unable to fill up a batch fully. This can occur when the remaining number of items to be backed up on the source does not exceed the number specified in this parameter.
SharePointOnlineBackupBatchTimeout
Timeout (in minutes) when downloading by batch from a cloud source during backup of SharePoint data for Cloud (Microsoft Office 365) backup sets.
Default: 720
Range: 1 to 1440
SharePointOnlineLargeFileRestoreThreshold
Configures the chunk size in MB for SharePoint Online uploads for Backup from the Cloud (Microsoft Office 365) backup sets. Files smaller than this value are uploaded whole.
Default: 8
Range: 1-2000
ShowPOSIX
Displays the Backup as POSIX check box in the New Backup Set Wizard (for File System & Permissions Only backup sets).
You can only select this option when creating a backup set. It cannot be configured from backup set properties.
No = Off (Default)
Yes = On
SQLKeepDumpFile
Keeps Microsoft SQL Server backup set database dumps in the dump location after backup. This only applies to the ‘classic’ Microsoft SQL Server backup set (not the VSS-aware version).
No = Off (Default) — Dump is deleted after backup has finished.
Yes = On — Dump is kept in the dump location. It will be overwritten during the next backup of that set. Note the storage implications, since this affects all Microsoft SQL Server backup sets created on the DS-Client.
StopOnRetrieveLSNFailed
For Microsoft SQL Server (VSS-aware) backup sets. Stops a differential backup if it failed to retrieve the LSN (Log Sequence Number) information of the previous full backup.
Yes = On (Default)
No = Off
VMReplicationOpenListingTimeOut
Timeout (in seconds) for listing the vCenter Server destination folders when you create a VM replication set.
Default: 300
Range: 0-3600
VMRExternalIP
Allows you to specify an external IP address to use to communicate with replication services on machines that are outside of the network domain.
Default: None — Uses the internal IP address to communicate with replication services on machines on the same network domain.
VMRServiceStart
Start the VM Replication Service when DS-Client starts.
Yes = On (Default) — You can create new VM replication sets and run replication as long as DS-Client has sufficient VM Replication Capacity.
No = Off — The category DS-Client replication sets is hidden in the New Backup Set Wizard, and existing replication sets are inaccessible.
VMRSourcePort
This parameter allows you to specify the port used by a DS-Client for VM replication processes. Ensure that this value matches the network configuration for the DS-Client.
 
This parameter is equivalent to the source DS-Client port number in DS-Operator. Changes made to this value through either DS-User or DS‑Operator are synchronized and will be shown in both interfaces.
 
Default: 8090
 
Note: This parameter requires the DS-Client to restart before taking effect.
VMwareVADPBackupValidateSignature
Forces all VMware VADP backup sets that have Changed Block Tracking (CBT) enabled to validate the disk signature of a protected virtual machine after a specified number of backups. The interval count starts from the first backup after the setting is enabled. If a disk signature mismatch is detected, a master generation is sent to the DS-System for the affected virtual disk (vmdk). Verification consumes more system resources and increases the backup time, especially if the signature verification fails and requires backup of a new master.
-1 = Disables disk signature validation for all affected backup sets.
0 (Default) = Uses the disk signature validation setting configured for each backup set.
1 = Validates the disk signature after every backup for all affected backup sets.
2 to 100 = Validates the disk signature after the specified number of backups for all affected backup sets.
Note: The disk signature validation setting will be reset to 0 each time the setting is applied to all affected backup sets.
VMwareVADPTransportMode
This applies to VMware VADP backup sets. It does not apply to VM replication sets (VMware).
 
Transport mode that DS-Client requests from the VMware libraries when initializing a connection for data transfer to or from a data center.
Empty (Default) — The library automatically chooses the transport mode based on the VMware priorities among the available transport modes.
nbd — Network Block Device Transport Mode.
nbdssl — Network Block Device SSL Transport Mode.
san — SAN Transport Mode.
hotadd — HotAdd Transport Mode.
For more information about the transport modes, see “Using VMware transport libraries”.
VSSContinueIfSnapshotCreatedWithWriterErrors
Continues a VSS-aware backup even if there are VSS writer errors, as long as the snapshot is successful. This only occurs after attempting all configured retries (VSSSnapshotRetries).
Yes = On (Default)
No = Off
VSSSnapshotRetries
DS-Client retries this number of times to create an ‘error-free’ snapshot during a VSS-aware backup.
Default: 3
Range: 0-999, (0 means backup will fail if snapshot encounters VSS writer errors)
VSSSnapshotRetryInterval
The retry interval (in minutes) for VSS snapshot retries (VSSSnapshotRetries).
Default: 5
Range: 1-99
VSSWaitSnapshotTimeout
Timeout (in seconds) to wait for VSS snapshot creation. A longer period can prevent backup failures if different backup sets need to perform VSS backups of a common volume at nearly the same time. (Only one VSS snapshot can be performed on a volume at a time. Since snapshots are fairly fast, a timeout of 5-15 minutes should ensure two different backups of the same volume can be successfully completed, even if they overlap.)
Default: 60
Range: 1-3600
WaitConfirmation
Time (in seconds) that DS-Client waits for confirmation from DS-System if stopping a backup.
Default: 60
Range: 0 to 3600