Upgrading the Client to D.SIDE 2.6
When installing version 2.6 of D.SIDE, it is possible to recover elements from a previous client if an earlier version is being used:
- User preferences
- Real-time and Replay connection history
- Link to the “Reference Database” in the D.SIDE Console, when it has been configured
To do this, simply run the upgrader from the D.SIDE 2.6 directory once the installation is complete.
Interactive Upgrade
To launch the upgrader, you can either double-click the d.side.upgrader.jar program located in the directory where D.SIDE 2.6 is installed or run the following command from the same directory:
java -jar d.side.upgrader.jar
In both cases, the main upgrader window will open:
The upgrader knows where to apply the preferences or connection history because it uses the directory from which it was called (the D.SIDE 2.6 directory). All that remains is to specify the location of the previous version from which you want to recover the elements (user preferences, connection history, etc.).
This is the purpose of the “Source directory” field, which can be filled in manually or by navigating using the “Browse” button:
Once the source and destination directories are specified, clicking the “Upgrade” button starts the process of transferring elements from the source (e.g., D.SIDE 2.5) to the destination (D.SIDE 2.6).
Hovering over the “Upgrade” button allows you to verify that you are working in the correct directory.
Once the client upgrade to version 2.6 is complete, the upgrader summarizes the operations it has performed:
All that remains is to close the window to exit the upgrader.
Command-Line Upgrade
You can also perform the upgrade without entering the upgrader window. To do this, you provide the source and destination directories to the upgrader through parameters passed to the Java program. Example:
java -jar d.side.upgrader.jar -source_directory D:\Downloads\D.SIDE\D.SIDE_2.5 -destination_directory D:\Downloads\D.SIDE\D.SIDE_2.6
The upgrader can then proceed without further interaction from the user, and a report detailing the operations performed will be displayed to outline each step:
The upgrade process can thus be automated, for example, if you want to upgrade multiple client machines to D.SIDE version 2.6.