The LiteSpeed command-line utility (SLSFastCompression.exe) allows you to conduct full and differential backups directly from your operating system command-line.
slsFastCompression.exe ( -? | --ShowHelp | --SDShowSyntax |
<FastCompression_backup_options> <Connection_options> |
<FastCompression_verify_option> <Connection_options> |
<FastCompression_backup_options> <FastCompression_verify_option> <Connection_options> )
FastCompression backup options:
--SDBackupDirectory <path>
[--SDForceFull |--SDForceDifferential ]
--SDExtentsChgRatioRequireFull <value> |--SDDiffToFullRatioRequireFull <value>
[--SDCheckForFullBackup]
[--SDFullBackupEscalation]
[--SDElapsedDaysRequireFull <n>]
[--SDSpecificDaysForbidFull (<day>,...)]
[--AltDir <path>]
[--SDMirrorDirectory <path>...]
[--SDAppendDifferential] ]
[-F --FastCompressionExtension]
FastCompression verify option:
[--SDVerify (Last|Full,Last|All)]
Accepted LiteSpeed arguments:
[-t <number_of_threads>]
[-X <options>]
[-A <affinity_mask> ]
[-L (0|1|2)]
[-W <with_arguments>]
[-n < backup_name>]
[-d <backup_description>]
[-p <priority_level> ]
[--AdaptiveCompression (Speed|Size) | -C < compression_level> ]
[-e <encryption_level> (-K <encryption_key>| --JobP <encrypted_key>)]
[-Y <comment> ]
[--attachedfile <path_or_file>]
[-h 1...100]
[-o <buffer_count>]
[-x <maximum_transfer_size>]
[-M --OLRMap]
[--MultiDatabaseType <all, system, user, selected>]
Connection options:
-D <database_name>
-S <server_name>
(-U <username> -P <password>) |-T]
TSM connection options:
[
-j <TSM_configuration_file>
[-c <TSM_client_node> ]
[-k <TSM_client_owner_password>]
[--TSMDeviceTimeoutMinutes <minutes>]
[-l <TSM_filespace>]
[-z <TSM_management_class>]
]
Cloud connection options:
[--CloudVendor <vendor name>]
[--CloudAccessKey <key name>]
[--CloudAccessKeyEnc <encrypted key name>]
[--CloudAutoStriping <1 or 0>]
[--CloudAutoStripingThreshold <auto, number GB>]
[--CloudSecretKey <key name>]
[--CloudSecretKeyEnc <encrypted key name>]
[--CloudBucketName <bucket name>]
[--CloudRegionName <cloud region name>]
[--CloudEndpoint <cloud endpoint name : port>]
[--CloudCloudAcceptAllCertificates <0 or 1>]
[--CloudGovRegion <government region number>]
Proxy connection options:
[--ProxyHost <proxy host name>]
[--ProxyLogin <proxy server login credential>]
[--ProxyPassword <proxy server password credential>]
[--ProxyPasswordEnc <encrypted proxy server password credential>]
[--ProxyPort <proxy server port number>]
NOTES:
Argument |
Description |
---|---|
--AlterDir |
Specifies the directory where to search for the backup file. Note: AlterDIr replaced SDSearchAlternateBackupDirectory in LiteSpeed 8.6. Support for the old SDSearchAlternateBackupDirectory parameter will be gradually phased out. |
--SDAppendDifferential |
Appends data to an existing full backup file. |
--SDBackupDirectory |
Specifies a directory for the backup file. |
--SDCheckForFullBackup |
Checks if the expected full backup exists when backing up to separate files and returns a failure message if it is not found. If the full backup file does not exist, it performs a full backup. If the full backup file does exist, the decision to perform a new full or a differential backup will depend on other conditions specified. |
--SDDiffToFullRatioRequireFull |
Specifies the last differential backup size to last full backup size ratio. When exceeding the specified ratio LiteSpeed performs a full backup. This argument accepts one of the following formats:
|
--SDElapsedDaysRequireFull |
Specifies the minimum number of days since last full backup required to perform full backup. The default value is 14. |
--SDExtentsChgRatioRequireFull |
Specifies the minimum amount of database changes required for the full backup. This argument accepts one of the following formats:
|
--SDForceDifferential |
Forces differential backup. |
--SDForceFull |
Forces full backup. |
--SDFullBackupEscalation |
This option causes LiteSpeed to issue a full backup, if one of the following problems is discovered in the current backup set:
NOTE: If a problem is detected and a full backup is created through escalation, an error will be returned. This argument accepts one of the following values:
|
--SDMirrorDirectory |
Specifies a directory for a mirror backup. You can supply multiple instances of this argument. |
--SDShowSyntax |
Displays the slsFastCompression syntax. |
--SDSpecificDaysForbidFull |
Specifies days of the week when a full backup is never performed. This argument accepts one of the following formats:
|
--SDVerify |
Performs a restore verification on the backup file just created (if backup was successful). This argument accepts one of the following values:
|
The following parameters work in conjunction with the Fast Compression parameters. See Syntax and Examples for more information.
-Argument |
--Argument |
Description | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(none) | --AdaptiveCompression |
Automatically selects the optimal compression level based on CPU usage or Disk IO. For more information, see Compression Methods. You can tell Adaptive Compression to optimize backups either for size or for speed. This argument accepts one of the following values:
| |||||||||||||||||||||
-A |
--Affinity |
Processor affinity designates specific processors to run LiteSpeed, while not allowing LiteSpeed to run on the remaining processors. This argument accepts decimal values and hexadecimal values. If a value begins with "0x" it is interpreted as hexadecimal. A positive 64-bit integer value translates to a binary mask where a value of 1 designates the corresponding processor to be able to run the LiteSpeed process. NOTE: 32-bit Windows is internally limited to a 32-bit mask. For example, you need to select processors 2, 3, and 6 for use with LiteSpeed. Number the bits from the right to left. The rightmost bit represents the first processor. Set the second, third, and sixth bits to 1 and all other bits to 0. The result is binary 100110, which is decimal 38 or hexadecimal 0x26. Review the following for additional information:
Tip: Before you start tuning the CPU Throttle or Affinity parameters to adjust backup performance, try limiting the number of threads. If you decide to use an affinity value other than default, it is recommended that you limit the threading as well. You may also want to consider using Adaptive Compression to maintain backup performance. For more information, see Adaptive Compression. | |||||||||||||||||||||
(none) |
--AttachedFile |
Specifies a file or directory (and all nested files and directories) to attach with this backup operation. You can supply multiple instances of this argument.. | |||||||||||||||||||||
-d |
--BackupDescription |
Specifies a description to store with the backup. This argument accepts variables. For more information, see LiteSpeed Variables. | |||||||||||||||||||||
-n |
--BackupName |
Specifies the name of the backup set. This argument accepts variables. For more information, see LiteSpeed Variables. | |||||||||||||||||||||
-o |
--BufferCount |
Specifies the number of SQL Server buffers available for a LiteSpeed operation. The default value is set by SQL Server. NOTE: LiteSpeed defaults typically result in the best performance. You should only modify advanced options after careful planning and testing. | |||||||||||||||||||||
-Y |
--Comment |
Appends a user comment to the backup. This argument accepts variables. For more information, see LiteSpeed Variables. | |||||||||||||||||||||
-C |
--CompressionLevel |
Specifies the compression level for the backup. Valid values are 0 through 8. 0 bypasses the compression routines. The remaining values of 1 through 8 specify compression with increasingly aggressive computation. 2 is the default value for disk backups and 7 is the default value for cloud backups. When choosing a compression level, it is best to try various options using your equipment and data to determine the best option for your environment. Use the Backup Analyzer to test the performance of different compression levels. For more information, see Test Optimal Backup Settings. NOTE: If both the compression level and Adaptive Compression option are passed in, LiteSpeed will not error out and will select and use Adaptive Compression. | |||||||||||||||||||||
-D |
--Database |
Name of database to be backed up or restored. | |||||||||||||||||||||
-e |
--EncryptionLevel |
Specifies encryption level. Works in conjunction with the Key (K) parameter. This argument accepts one of the following values:
| |||||||||||||||||||||
-y |
--Expiration |
Specifies the date and time when the backup expires. LiteSpeed will not overwrite this file until expiration datetime is passed. This argument accepts one of the following formats:
| |||||||||||||||||||||
(none) |
--FastCompressionExtension |
Specifies the fast compression file extension. This argument accepts one of the following formats:
| |||||||||||||||||||||
-f |
--File |
Specifies a logical database file used for file or filegroup backups. You can supply multiple instances of this argument. | |||||||||||||||||||||
-g |
--FileGroup |
Specifies a database filegroup to include in the backup or restore. You can supply multiple instances of this argument. A filegroup backup is a single backup of all files in the filegroup and is equivalent to explicitly listing all files in the filegroup when creating the backup. Files in a filegroup backup can be restored individually or as a group. | |||||||||||||||||||||
-X | --Ioflag |
Specifies if LiteSpeed should wait and retry the read or write operation on failure. You can define retry options using the following parameters:
NOTE: This functionality is only available for disk and cloud operations. | |||||||||||||||||||||
-K |
--Key |
Value used to generate the encryption key for the encryption algorithm. If you do not supply encryption key, then the program will not encrypt the backup. If you use the wrong encryption key, the restore will fail. Caution: When encrypting data, take care not to lose the encryption key; a backup cannot be restored or recovered without the original encryption key. Example of key: 'Mypassword' | |||||||||||||||||||||
-L |
--LogLevel |
Creates a log file. This argument accepts one of the following values:
The default output directory is C:\Documents and Settings\All Users\Application Data\Quest Software\LiteSpeed\SQL Server\Logs (or C:\ProgramData\Quest Software\LiteSpeed\SQL Server\Logs) (or C:\ProgramData\Quest Software\LiteSpeed\SQL Server\Logs). To log to a different directory run this utility with the following argument: --trace logpath = "path". | |||||||||||||||||||||
-x |
--MaxTransferSize |
Specifies the largest unit of transfer in bytes to be used between SQL Server and LiteSpeed. The possible values are multiples of 65536 bytes (64 KB) ranging up to 4,194,304 bytes (4 MB). The default is 1048576 (1 MB). | |||||||||||||||||||||
(none) |
--MultiDatabaseType |
Produces a backup that includes several types of databases. Types can include: all, system, user, or selected databases. This argument accepts one of the following values:
| |||||||||||||||||||||
-M |
--OLRMap |
Generates a map file during a backup for Object Level Recovery. This argument accepts one of the following values:
| |||||||||||||||||||||
(none) |
--Password |
Specifies the user password. Passwords are case-sensitive. Required if the connection type is not a trusted connection. | |||||||||||||||||||||
-p |
--Priority |
Specifies the priority of the LiteSpeed process compared to other processes running on the same server. This argument accepts one of the following values:
| |||||||||||||||||||||
(none) |
--Read_Write_Filegroups |
Specifies a partial backup, which includes the primary filegroup and any read-write secondary filegroups. | |||||||||||||||||||||
-r |
--RetainDays |
Specifies a number of days to retain the backup. LiteSpeed will not overwrite this file for this number of days. | |||||||||||||||||||||
(none) |
--SDDryRun |
Displays backups that are to be removed (delete candidates) or kept according to the specified conditions and SmartCleanup logic. SmartCleanup does not remove any backups, if this parameter is specified. | |||||||||||||||||||||
-S |
--Server |
Specifies the instance of Microsoft SQL Server to connect to. This argument accepts one of the following values:
If no server is specified, the LiteSpeed command-line utility will connect to the default instance of SQL Server on the local computer. | |||||||||||||||||||||
-? |
--ShowHelp |
Displays the syntax summary of the LiteSpeed command-line utility. | |||||||||||||||||||||
-t |
--Threads |
Determines the number of threads used for the backup. You will achieve the best results by specifying multiple threads, but the exact value depends on several factors including: processors available, affinity setting, compression level, encryption settings, IO device speed, and SQL Server responsiveness. The default is n-1 threads, where n is the number of processors. | |||||||||||||||||||||
-h |
--Throttle |
Specifies the maximum CPU usage allowed. The argument accepts an integer value between 1 and 100. The default value is 100. This is the percentage of the total amount of CPU usage (across all enabled processors) available. TIP: Before you start tuning the CPU Throttle or Affinity parameters to adjust backup performance, try limiting the number of threads. If you decide to use an affinity value other than default, it is recommended that you limit the threading as well. You may also want to consider using Adaptive Compression to maintain backup performance. For more information, see Adaptive Compression. | |||||||||||||||||||||
-U |
--UserId |
Specifies user login ID. Required if the connection type is not a trusted connection. Login IDs are case-sensitive. | |||||||||||||||||||||
(none) |
--Verify 1 | Performs a restore verification on the backup file just created (if backup was successful). | |||||||||||||||||||||
-W |
--With |
Specifies strings that will be passed directly to SQL Server in the backup/restore SQL. Some of the accepted parameters are the following:
|
The following arguments work in conjunction with the Fast Compression arguments and accepted LiteSpeed arguments. See Syntax and Examples for more information.
-Argument |
--Argument |
Description |
---|---|---|
-c |
--TSMClientNode |
Specifies the TSM server LiteSpeed connects to during backups and restores. Not required, if specified in the options file or if backing up with the Passwordaccess Generate option. |
-k |
--TSMClientOwnerPwd |
Specifies the TSM client owner user password. Not required, if specified in the options file or if backing up with the Passwordaccess Generate option. |
-j |
--TSMConfigFile |
Specifies the TSM configuration file. |
(none) | --TSMDeviceTimeoutMinutes |
Specifies how long to wait for a TSM device. |
(none) | --TSMdsmi-dir |
DSMI_DIR path if needed. |
(none) | --TSMdsmi_log |
DSMI_LOG path. |
-l |
--TSMFileSpace |
Specifies the TSM file space, the logical space on the TSM server. It can be the drive label name or UNC name. You can supply multiple instances of this argument. NOTE: IBM recommends that an application client should select a unique file space; it is recommended that LiteSpeed users follow this practice with a specific file space reserved for LiteSpeed backups. |
(none) | --TSMLogname |
Log name. |
-z |
--TSMMgmtClass |
Specifies the TSM management class. If not specified, LiteSpeed uses the default management class. |
Cloud arguments work in conjunction with the LiteSpeed arguments. See Syntax and Examples for more information.
-Argument |
--Argument |
Description | |
---|---|---|---|
(none) | --AWSUseServerSideEncryption |
The @AWSUseServerSideEncryption argument enables the encryption of data stored at rest in Amazon S3. This argument accepts one of the following values:
| |
(none) | --AzureBlobType |
The @AzureBlobType argument specifies the types of blobs that can be stored in the Microsoft Azure cloud storage. This argument accepts one of the following values: "Block", "Page".
| |
(none) | --CloudAccessKey |
The @CloudAccessKey argument specifies the name of the unique Cloud Web Service alphanumeric access key that identifies each user. The selections include Amazon Access Key, Azure Account Name, Google e-mail styled account, S3 Compatible Storage Access Key. | |
(none) | --CloudAccessKeyEnc |
The @CloudAccessKeyEnc argument specifies the name of the encrypted unique Cloud Web Service alphanumeric access key that identifies each user. | |
(none) | --CloudAutoStriping |
This parameter enables automatic file striping for LiteSpeed cloud backups. | |
(none) | --CloudAutoStripingThreshold |
This parameter contains the stripe size in GBs. LiteSpeed logic uses the database size to make a decision about the number of stripes needed for LiteSpeed cloud backups. For example, if you have a database with a size of 200GB and set @CloudAutoStripingThreshold = 50, then LiteSpeed uses 200/50 = 4 stripes. | |
(none) | --CloudBucketName |
The @CloudBucketName argument specifies the name of the container for cloud objects. Bucket names must be at least 3 and no more than 63 characters long. The selections are Amazon Bucket Name, Azure Container Name, Google Bucket Name, Google Bucket Name requirements are described at https://cloud.google.com/storage/docs/naming, S3 Compatible Storage Bucket Name, | |
(none) | --CloudGovRegion |
The @CloudGovRegion argument enables a special restricted region for the US Government use in Amazon S3 and Azure Clouds. This argument accepts one of the following values:
| |
(none) | --CloudRegionName |
The @CloudRegionName argument specifies the name of the Cloud Web Service region to use for a bucket. Example values are but not limited to: us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-central-1, eu-west-1, eu-west-2, ap-south-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, ap-northeast-2, sa-east-1, N'Germany' and N'China'. | |
(none) | --CloudSecretKey |
The @CloudSecretKey argument specifies the name of the Cloud Web Service secret key that is assigned when you initially get a Cloud account. | |
(none) | --CloudSecretKeyEnc |
The @CloudSecretKeyEnc argument specifies the name of the encrypted Cloud Web Service secret key that is assigned when you initially get a Cloud account. | |
(none) |
--CloudStorageClass |
The @CloudStorageClass argument specifies a range of storage classes established for different use cases including: For Amazon S3:
For Google Storage:
| |
(none) | --CloudVendor |
The @CloudVendor argument specifies the name of the cloud service provider. The argument accepts one of the following values: "AmazonS3", "AzureBlob", "GoogleStorage" or "S3Compatible". | |
(none) | --CloudEndpint |
The @CloudEndpoint argument specifies the endpoint for S3 Compatible Storage and custom endpoint for Amazon S3 service (in case of VPC). Format: servername:port .Example values: "servername", "servername:port", "ip:port", "10.0.0.200:9021". | |
(none) | --CloudAcceptAllCertificates |
The @CloudAcceptAllCertificates argument instructs LiteSpeed accept self-signed certificates for S3 Compatible Storage. This argument accepts one of the following values:
Note: Delete backups is not supported in Maintenance Plans with this option. | |
(none) | --GSProject |
DEPRECATED LiteSpeed 8.8: Was used to store for the Google Cloud Storage project ID; the project ID is now obtained from login. This parameter is retained for compatibility with old backup/restore scripts. | |
(none) |
--UseSSL |
The @UseSSL argument specifies that the connection uses SSL security. This argument accepts one of the following values:
|
Proxy arguments work in conjunction with the LiteSpeed arguments. See Syntax and Examples for more information.
-Argument |
--Argument |
Description | |
---|---|---|---|
(none) |
--ProxyHost |
The @ProxyHost argument is optional and specifies the name of the proxy host name that is running the proxy server.
| |
(none) | --ProxyLogin |
The @ProxyLogin argument is optional and specifies the proxy server login credential.
| |
(none) | --ProxyPassword |
The @ProxyPassword argument is optional and specifies the proxy server password credential.
| |
(none) | --ProxyPasswordEnc |
The @ProxyPasswordEnc argument is optional and specifies the encrypted proxy server password credential.
| |
(none) | --ProxyPort |
The @ProxyPort argument is optional and contains the port number of the proxy server. The TCP/IP port values can be 1-65535.
|
Back up the Northwind database. Perform full backup only if the amount of database changes since the last full backup is more than 40%.
SLSFastCompression.exe --SDBackupDirectory "C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup" --SDExtentsChgRatioRequireFull ".4" -D Northwind -S SPB9771
Back up the Northwind database to multiple locations. Perform full backup only if more than 10 days have passed since last full backup. Full backup escalation option is on.
SLSFastCompression.exe --SDBackupDirectory "C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup" --SDMirrorDirectory "D:\SQLServerBackups" --SDElapsedDaysRequireFull 10 --SDFullBackupEscalation -S SPB9771 -D Northwind
Back up the Northwind database. Force full backup.
SLSFastCompression.exe --SDBackupDirectory "C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Backup" --SDForceFull -D Northwind -S SPB9771
Back up to TSM using the Passwordaccess Generate option specified in the option file. Perform full backup only if the amount of database changes since the last full backup is more than 40%.
SLSFastCompression.exe -D LiteSpeedLocal -C 2 --SDExtentsChgRatioRequireFull ".4" --TSMFileSpace "FC" --TSMConfigFile "C:\Program Files\Tivoli\TSM\baclient\dsm_pg.opt" --TSMMgmtClass "STANDARD" --tsmdevicetimeoutminutes 2 --SDFullBackupEscalation --SDElapsedDaysRequireFull 14 -S"W2K5_TSM" -U"sa" -P"***"
Back up to Amazon S3 cloud.
TIP: Command line fast compression backups only work with the encrypted access information. They will fail if the access info is not encrypted.
SLSFastCompression.exe --SDBackupDirectory "fc" --SDExtentsChgRatioRequireFull ".4" -D model --CloudVendor "AmazonS3" --CloudBucketName "california" --CloudAccessKey "*****" --CloudSecretKey "*****" --CloudRegionName "us-west-1" --UseSSL -S"servername" -T
Back up to Google Storage
SLSFastCompression.exe -S "LSSQL17" -T -D "proddb" --compressionlevel 7 --OLRMAP 1 --SDExtentsChgRatioRequireFull ".4" --SDBackupDirectory "fc" --CloudVendor "GoogleStorage" --CloudAccessKey "name@lsnewproject.iam.gserviceaccount.com" --CloudSecretKey "***" --GSProject "yourProjectID" --CloudStorageClass "nearline" --CloudRegionName "us" --CloudBucketName "mybucket" --UseSSL 1 --SDFullBackupEscalation --SDElapsedDaysRequireFull 14
Note: --CloudSecretKey is a full text key that starts with “-----BEGIN PRIVATE KEY-----” and ends with “-----END PRIVATE KEY-----”
0 (success) or 1 (failure)
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center