DS-Client Auto Upgrade
- Note: For more information on versioning, see the Knowledge Base article "Versioning (DS-Software component numbering)".
Each time a DS-Client connects, the DS-System validates the DS-Client's version number v."N.X.y.z" (for example: v.7.5.2.1), where
- N = Major release (e.g. 7)
- X = Minor release (e.g. 5)
- y = Service Pack number (e.g. 2)
- z = Hot Fix (e.g. 1)
If the upgrade package on the DS-System is higher than the current DS-Client version, the DS-Client will upgrade itself.
By default, DS-System is configured to automatically upgrade its DS-Clients.
- This property is set in the DS-System Advanced Configuration "AutoUpgrade" parameter. (See "DS-System Advanced Configuration".)
The default autoupgrade folder depends on the type of autoupgrade package:
- Full Release (e.g. v.7.0): <Backup_Root>\Upgrade\Default\
- Service Pack (e.g. v.7.0 SP1): <Backup_Root>\Upgrade\
- Hot Fix (e.g. v.7.0 Hot Fix 1): <Backup_Root>\Upgrade\
- Note: In addition to the default Hotfix upgrade folder, you can assign a specific hotfix folder to individual DS-Clients. For more information, see "Hotfix Directory".
The autoupgrade package filename identifies the version and platform of the DS-Client:
To configure the upgrade package with different software branding (for DS-Clients of a specific Sales Group) you must use the DS-Billing GUI:
- From the DS-Billing GUI's Business Tab, highlight the Sales Group > Right-click Edit.
- For more information, see: "Billing (DS-Billing Module)".
Changing the path of the AutoUpgrade folder
By default, the AutoUpgrade folder is set under the <Backup_Root> Primary Storage location (i.e. the first storage location that was defined on the DS-System). It is strongly recommended that you use this default, since the contents of the Upgrade folder will be automatically updated when you install newer versions of the DS-System.
You can, however, change the Upgrade subdirectory to any location visible to the DS-System. To do this, edit the dssys.cfg file's "Upgrade" key with the full path to the new location:
- This must be a valid physical drive or UNC path that DS-System can access (without supplying a username / password).
- It cannot be a Mapped drive.
- Remember to restart the DS-System after changing the dssys.cfg file.
- You will have to manually copy any new upgrade files to this directory.
Note for Windows DS-Systems with Service Packs (e.g. v.7.0 Service Pack 2)
In order to keep the DS-System upgrade packages to a reasonable size, Windows DS-System Service Packs do not include the upgrade installations for UNIX DS-Clients (Linux / Mac).
To configure a Windows DS-System for Auto Upgrade to UNIX DS-Clients:
1. From the Service Pack DVD's Windows DS-System sub-folder, copy the UNIX DS-Client upgrade packages (e.g. dsclni_7_0_2_0.lin64).
2. Place the upgrade packages in the Windows DS-System's <Backup_Root>\Upgrade\ (defined in the dssys.cfg file).
- This is the same folder where the Windows DS-Client upgrade packages are located (dsclni_N_X_y_z.win & dsclni_N_X_y_z.win64).
Hot Fix packages (e.g. v.7.0 Hot Fix 1)
Hot Fixes (e.g. dsclni_7_0_0_1.win64) are released when required by Asigra. You have two options for Hot Fixes:
- The packages can be copied directly in the DS-System's "Upgrade Path" defined in the dssys.cfg file (by default <Backup_Root>\Upgrade\).
- The packages can be copied to a uniquely named sub-folder of this path (e.g. "Hotfix_11_0_0_1"). These Hotfixes will only be applied to DS-Clients configured to upgrade. See "Hotfix Directory".
![]() ![]() |