Software Upgrades

​

Upgrading 2025 to a Newer Build

​

Microsoft Windows

1. Stop the server via Windows Services Manager.
2. Run setup.exe.
3. Point the installer to the location where is installed.
4. Restart the server as a service after the upgrade is completed.

​

Linux

1. Stop the server in either of the following ways:
   • To stop the server as a service, submit this command: sudo systemctl stop cdatasync
   • To stop the service in-process, submit this command: java -jar sync.jar -stop
2. Unzip the sync.war file from the tar.gz archive and place it in the /opt/sync/webapp/ directory. Unzipping the file in this location overwrites the old file.
3. (Optional) Unzip the sync.jar file from the tar.gz archive and place it in /opt/sync/. Unzipping the file in this location overwrites the old file.
4. Start the server in either of the following ways:
   • To start the server as a service, submit this command: sudo systemctl start cdatasync
   • To start the service in-process, submit this command: java -jar sync.jar

• No matter how you choose to deploy , the files and folders that are contained in ApplicationDirectory must be readable and writable by the user who runs the application. The service.sh script that is included with uses cdatasync as this user.
• If the application was previously run as a different user and you want to restore the necessary permissions for a cdatasync user to run the application, submit a command that is similar to the following: sudo chown -R cdatasync:cdatasync /opt/sync

​

Upgrading from 2020-2024

​

Cross-Platform Edition

​

Microsoft Windows

1. Stop the server via Windows Services Manager.
2. Run setup.exe.
3. Point the installer to the location where is installed.
4. Restart the server as a service after the upgrade is completed.

​

Linux

1. Stop the server in either of the following ways:
   • To stop the server as a service, submit this command: sudo systemctl stop cdatasync
   • To stop the service in-process, submit this command: java -jar sync.jar -stop
2. Extract the contents of .tar.gz to /opt/sync/.
3. Submit the following upgrade command only if you are upgrading from 2021 or earlier. Otherwise, continue to step 4. sudo bash /opt/sync/upgrade.sh Optional: You can specify the -InstallDirectory parameter if your previous installation uses a nondefault path.
4. Start the server in either of the following ways:
   • To start the server as a service, submit this command: sudo systemctl start cdatasync
   • To start the service in-process, submit this command: java -jar sync.jar

• No matter how you choose to deploy , the files and folders that are contained in ApplicationDirectory must be readable and writable by the user who runs the application. The service.sh script that is included with uses cdatasync as this user.
• If the application was previously run as a different user and you want to restore the necessary permissions for a cdatasync user to run the application, submit a command that is similar to the following: sudo chown -R cdatasync:cdatasync /opt/sync

​

.NET

1. If you use the default SQLite application database, you must export your settings and then re-import them when you start the Cross-Platform edition of . The Cross-Platform edition does not support SQLite as an application database. It uses the Apache Derby database, by default. You can export your settings from the Migrations tab on the Settings page in . Simply click Export to download all your jobs, connections, and settings into zipped CSV files.
   If you use PostgreSQL, MySQL, or SQL Server as your application database, you do not need to export your settings. The Cross-Platform edition supports these three application databases, and it will update the system tables when you start the Cross-Platform edition for the first time. As a best practice, you should create a backup of the system tables by copying them into a different database or schema.
2. (Optional) Rename the .NET application folder so that the new Cross-Platform edition will be installed in a separate folder.
3. Download and install the Cross-Platform edition from the website. During installation, the new download should overwrite the service definition.
   Before you start the server, you need to update the sync.properties file if you are using an external database. You can change the port, change the inactivity (session) timeout, and more in this file. For example, you can change the port by locating the following line in sync.properties and changing the default port (8181) to a port of your choice: cdata.http.port=8181
4. Start the application and install your license from the License tab on the Settings page.
5. Import the settings that you exported in step 1.

​

Upgrading from 2017-2019

• All jobs
• All connections
• Any external connectors
• All settings

​

Upgrading Marketplace Instances