Chat now with support
Chat with Support

LiteSpeed for SQL Server 8.5 - Engine User Guide

License LiteSpeed Engine

LiteSpeed Engine will work with either a LiteSpeed Engine for SQL Server license or a LiteSpeed for SQL Server Enterprise license. You may view or update licensing information using the Help | License option.

NOTES:

  • The license information is case sensitive. Please ensure that your license information is valid and entered accurately.
  • If the current license is expired, LiteSpeed Engine will create an entry in the Window’s Event Log. License error messages are only logged once per backup or upon reboot, so you may have to review the Event Log history to locate the message. You can quickly retrieve LiteSpeed Engine related Event Log entries by selecting Help | Support Bundle and clicking View log.

Configuration

About LiteSpeed Engine Configurations

A configuration file contains the file extensions to be monitored, as well as the compression level and encryption level employed by LiteSpeed Engine when creating a backup of the monitored file. By default, LiteSpeed Engine is configured to backup using Compression Level 1 without encryption. You may change these settings at any time. If no custom file extension settings are saved to the configuration file, only native SQL backups will occur.

Configuration settings are saved to the default .ini file (LSBackFilter.ini) and are saved in the Documents and Settings\All Users\Application Data\Quest Software\LiteSpeed\Engine directory. (The default location for the ini file on Windows Vista is: ProgramData\Quest Software\LiteSpeed\Engine.)

The default location is specified by the HKEY_LOCAL_MACHINE\Software\Quest Software\LiteSpeedEngine\IniPath registry key.

NOTE: The driver currently only updates using the default file name and from the default location. 

Contents of a Configuration File (.ini)

The configuration file is comprised of two main sections, the GLOBAL section and a sequentially numbered EXTENSION section for each custom file extension. The GLOBAL section contains licensing key information.

The EXTENSION section(s) are sequentially numbered according to the order in which they are entered. Each section contains information on the saved custom file extension settings. These setting may include the following:

  • FILE_EXTENSION (to which the section applies)
  • COMPRESSION_LEVEL
  • ENCRYPTION_LEVEL
  • RESTORE_PASSWORD (if the Include restore password... option is enabled)
  • ENCRYPTION_PASSWORD (if the Store password encrypted option is enabled)
  • CLEARTEXT_PASSWORD (if the Store password encrypted option is disabled)

NOTE: You need to update driver configuration each time you manually edit the configuration file. For more information, see Manage Configuration Files.

Customize Your Configuration

To add a file extension

  1. With your configuration file open, select the Edit | Add Extension option.
  2. Select the extension for monitoring from the defaults list, or manually enter an extension by clicking in the text portion of the drop down list. (This extension will be available from the drop down list the next time you add or edit an extension.) Review the following for additional information:
    Option Description
    Extension

    File extensions available for monitoring:

    • User Defined (Up to 16 characters in length.)
    • BAK
    • BKE
    • LSB
    • BKP
    • EXE
    • TRN
    Compression Level

    The degree of data compression:

    None Data will not be compressed.
    1

    Medium Compression—for servers where minimal CPU utilization is preferred at the expense of some compression.

    2

    Medium-High Compression—a new highly optimized low CPU algorithm for environments where low CPU utilization is preferred but with improved compression over level 1.

    3, 4, 5, 6 High Compression—for databases where balanced compressed backup size and CPU utilization is important.
    7, 8

    Extreme Compression—a new highly optimized extreme compression algorithm for databases where compressed size is very important with only a slight increase in CPU utilization over previous levels.

    Encryption Level

    Encryption algorithms used to encrypt data:

    • None (Data will not be encrypted.)
    • 64-bit RC2
    • 112-bit RC2
    • 128-bit RC2
    • 168-bit 3DES
    • 128-bit AES
    • 192-bit AES
    • 256-bit AES
    Encryption Password

    1 to 255 characters.

    This parameter is only set when data is encrypted.

    The user must maintain the password for each encrypted backup file. For appended backup files, the password must be available at the time of each backup, as SQL Server reads previous backup information, and therefore LiteSpeed must be able to decrypt that information when requested.

    CAUTION: If the password for a file extension is changed, previous backups cannot be restored until the proper password is re-associated with that file extension. Alternately, the file can be renamed to a new extension which is assigned the previous password.

NOTES:

  • By default, configuration settings are saved to the default .ini file.
  • Additions or edits may not be viewed in the .ini file until the configuration is saved.
  • Manually entered file extension can be removed from the drop-down list by removing the extension from the Available extensions list using the Tools | Options menu option.
Related Documents