Upgrade application version

This step-by-step guide is intended to outline the main steps for WebSpellChecker Server upgrade and reinstallation on the same server (hardware).

Starting from version 6.16.0.0, a license is tied to the product version it was activated for. After you upgrade WebSpellChecker Server, you must re-activate the license, including when you reinstall on the same server.

Until the license is re-activated, AppServer rejects every API request with:

License does not match the current product version. Please re-activate the license.

• If you plan to reinstall package v.5.4.0-5.7.1 on a different server, you need to deactivate a license first and activate it on a different server later. For details, refer to License Deactivation on Windows and Linux guides.

• 1. Stop AppServer

• 2. Back up Existing Setup Configuration and Files

  • 2.1. Files backup on Windows

  • 2.2. Files backup on Linux

• 3. Install a New Version of WebSpellChecker Server

• 4. Re-activate the license

• 5. Start AppServer

• 6. Verify Operability

1. Stop AppServer

It is recommended to stop AppServer of the existing installation before launching a new setup.

2. Back up Existing Setup Configuration and Files

Comments below apply to reinstallation and upgrade of WebSpellChecker Server on the same server.

2.1. Files backup on Windows

When reinstalling WebSpellChecker Server on Windows, the installer tries to auto-detect if any other versions of the package already exist. Select the Backup WebSpellChecker files option to back up any already existing configurations and other files.

Once you select the Backup the WebSpellChecker files option, settings files as well as dictionaries will be saved to C:\Program Files\WebSpellChecker\.Backup.

2.2. Files backup on Linux

When reinstalling WebSpellChecker Server on the same server on Linux, a directory containing files and dictionaries settings will be rewritten, and a backup copy will be created. During this rewriting process, a directory containing User and Server Custom Global dictionaries unique contents and their settings is saved. The default backup directory is /opt/WSC/.Backup.

3. Install a New Version of WebSpellChecker Server

Install a new version of the application following the steps from the appropriate manual.

4. Re-activate the license

Run the license activation using the same License Ticket ID:

• License activation on Windows

• License activation on Linux

The existing license is replaced with a license issued for the new version. The time left on your license is not affected.

If activation fails, see Common license errors.

5. Start AppServer

Once you completed all the upgrade/reinstallation steps, you need to start AppServer of your new installation.

6. Verify Operability

6.1 Check the status and the version of the new installation to verify if it works properly:

• AppServer version

• AppServer status

6.2 Confirm that the license is valid after the upgrade. Open the application logs and look for the License status record, as described in License verification. A line reporting a product version mismatch means the re-activation step was missed.

6.3 Check if grammar and spelling functionality works correctly after the upgrade/reinstallation in your web application, namely:

• Grammar and spelling are checked, incorrect words are underlined, and so on.

• User interface buttons and dialog windows are displayed correctly.