# 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).

* 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](https://docs.webspellchecker.net/display/WSDK/License+deactivation+on+Windows) and [Linux](https://docs.webspellchecker.net/display/WSDK/License+deactivation+on+Linux) guides.
* If you are reinstalling the application on the same server, you must **skip** the license activation step.<br>
* [1. Stop AppServer](#draft-upgradeapplicationversion-1.stopappserver)
* [2. Back up Existing Setup Configuration and Files](#draft-upgradeapplicationversion-2.backupexistingsetupconfigurationandfiles)
  * 2.1. Files backup on Windows
  * 2.2. Files backup on Linux
* [3. Install a New Version of WebSpellChecker Server](#draft-upgradeapplicationversion-3.installanewversionofwebspellcheckerserver)
* [4.Start AppServer](#4.-start-appserver)
* [5. Verify Operability](#draft-upgradeapplicationversion-5.verifyoperability)

### 1. Stop AppServer <a href="#draft-upgradeapplicationversion-1.stopappserver" id="draft-upgradeapplicationversion-1.stopappserver"></a>

It is recommended to [stop AppServer](https://docs.wproofreader.com/v6.12.0/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-stopappserverwindowslinux2.stopappserver) of the existing installation before launching a new setup.

### **2. Back up Existing Setup Configuration and Files** <a href="#draft-upgradeapplicationversion-2.backupexistingsetupconfigurationandfiles" id="draft-upgradeapplicationversion-2.backupexistingsetupconfigurationandfiles"></a>

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**.

<figure><img src="/files/hQ1euBUjwpmBFqAwnq8P" alt=""><figcaption></figcaption></figure>

**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 <a href="#draft-upgradeapplicationversion-3.installanewversionofwebspellcheckerserver" id="draft-upgradeapplicationversion-3.installanewversionofwebspellcheckerserver"></a>

Install a new version of the application following the steps from the appropriate [manual](/v6.12.0/deployment/installation.md).

### 4. Start AppServer

Once you completed all the upgrade/reinstallation steps, you need to [start AppServer](https://docs.wproofreader.com/v6.12.0/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-startappserverwindowslinux1.startappserver) of your new installation.

### 5. Verify Operability <a href="#draft-upgradeapplicationversion-5.verifyoperability" id="draft-upgradeapplicationversion-5.verifyoperability"></a>

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

* [AppServer version](https://docs.wproofreader.com/v6.12.0/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-3.checkappserverversion)
* [AppServer status](https://docs.wproofreader.com/v6.12.0/deployment/installation/pages/IA2KNQLXDh85TwDivL4y#mainappservercommands-4.checkappserverstatus)

5.2 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wproofreader.com/v6.12.0/deployment/installation/upgrade-application-version.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.