Update DSA Server

Make a backup copy of the entire DSA Server folder before attempting an update.

Update From Repository

The standard way to update DSA Server to the latest version is to use DGLux UI and /sys node on the Data tab.

1. Open DGLux UI and switch to the Data tab.
2. Right-click /sys node -> Update -> Server from Repository -> Invoke
3. After update is completed successfully, restart server with right-click /sys -> Restart Server.

If you update the Server from version 1455 or older, please follow the instructions in the "Updating from old version" paragraph below.

To check server build, click on the /sys node and look for Server Build value on the Metrics panel.

Update From Zip

Another way to update the server to a specific version is to update from a zip file.

1. Download DSA Server zip from distribution repository on GitHub.
2. Open DGLux UI and switch to the Data tab.
3. Right-click /sys node -> Update -> Server from Zip -> Select file and Invoke
4. After update is completed successfully, restart server with right-click /sys -> Restart Server.
5. Verify your Server build is correct.

Manual Update

If DGLux UI is not available, follow these steps to update DSA Server using the file system. Ensure you have either ssh or remote desktop access to the server's file system.

1. Download DSA Server zip from distribution repository on GitHub to a folder on your server.
2. Unzip the zip file.
3. Copy over all folders and files to your DSA Server's folder. Make sure you only overwrite core files and keep all the custom files in the server folder, including server.json.
4. Restart DSA Server using an executable file in the /bin folder:
   1. On Linux: ./bin/daemon.sh restart
   2. On Windows: bin\daemon.bat restart
   3. On Windows with Server installed as a service: restart service using Service Management tool.

Updating a Version 1455 or Below

Every server update comes with bundled DGLux 5 application. There is a known issue when updating DSA Server from version 1455 or below. It is likely that you end up with two folders for DGLux 5 and when restarted, the server can incorrectly load the older version of the DGLux 5. In order to work around this, please follow these steps:

1. After performing an update, manually stop the server using the command line:
   1. On Linux: ./bin/daemon.sh stop
   2. On Windows: bin\daemon.bat stop
   3. On Windows with Server installed as a service: stop service using Service Management tool.
2. Open www folder in your server directory.
3. Because of the renaming you should notice one or all three folders with names asb, dgsb, dglux5. Our goal is to keep only one dglux5 folder.
4. If you were previously using asb or dgsb folder, please remove them and keep only dglux5 folder.
   1. Note that if you were using custom html/css/js files in that folder, you should copy them over to dglux5 folder before deletion.
5. Start server using the command-line tool:
   1. On Linux: ./bin/daemon.sh start
   2. On Windows: bin\daemon.bat start
   3. On Windows with Server installed as a service: start service using Service Management tool.
6. Check DGLux 5 version using the main menu Help -> About. It should be the version packaged with the server build to which you updated.