Skip to main content
Version: Next

Data Client upgrade guide

The upgrade process for a Data Client is relatively straightforward.

The same configured installation script used on first-time installation is used to do the upgrade, unless otherwise noted.

The existing appsettings.datasources.json will be retained, keeping all existing connections to data sources and data sinks. Every other file in the deployment folder will be removed or replaced.

Before You Upgrade​

Backup appsettings.datasources.json and appsettings.json from the installation folder. These contain connection and setup information that can be copied back in case something is accidentally overwritten.

Upgrade Procedure​

  • Stop the LinXmart Data Client service
  • Copy the installation folder to a local folder on the server
  • Run a Command Prompt (cmd.exe) as administrator
  • Verify run-setup-dataclient-service.ps1 is configured with the correct properties - these should remain the same as they were when first installed
  • Run run-setup-dataclient-service.ps1
  • Enter the API key for the Data Client when prompted (this can be obtained from the backed-up appsettings.json file if not accessible elsewhere)
  • Enter the password of the service account when prompted
  • Start the LinXmart Data Client service