The WebSpellChecker licenses are hardware-based. The operations such as a MAC address or network interface update, migration to another environment or any hardware manipulations which will affect our application/license should be performed according to the manual below.

Before you begin:

  • You are eligible to ask for assistance during the migration procedure as long as your WebSpellChecker Maintenance Agreement is active. 

1. Obtain Temporary License

According to the migration procedure, you are required to install and configure a new server with a 30-day temporary license first. Prior to migration procedure, you need to inform the WebSpellChecker team by sending a request to support@webspellchecker.net and ask to provide a 30-day temporary license.

When sending an inquiry, it is also recommended to specify the following information:

  • What is the reason for migration? 
  • What are the License type and License Ticket ID which you want to migrate to a new server (e.g. Dev/QA server license, ZUBI77PX7H8CGV3HKx5xS5GzE)?
  • Do you plan to migrate currently installed version of the application or upgrade to the most recent available?
  • What are technical charactericts of a new server (Operating System, Web or Application Server)?

2. Install WebSpellChecker

Depending on the type of the environment where you are migrating the application, refer to one of the installation manuals below.


 Installing WebSpellChecker Server on a Windows server...


 Installing WebSpellChecker Server on a Linux server...

3. Activate Temporary License

As soon as you completed the main installation steps, you need to activate a 30-day temporary license ticket accordingly.


 Click here to learn how to activate a license on a Windows server...

Visit the Licensing WebSpellChecker on Windows guide to find out how to activate a license on a Windows server.


 Click here to learn how to activate a license on a Linux server...

Visit Licensing WebSpellChecker on Linux guide to find out how to activate a license on a Linux server.

4. Verify Operability

4.1. Prove Application Operability

Once you activated a 30-day license, you need to verify if the application works properly after the migration.

First of all, you need to check the application version and status. The version check will confirm the exact version of the application that you are running. The status check will provide you the health statuses of the main application engines: Spell Check, Grammar, Thesaurus.

In addition to the version and status checks, you have to ensure that integrated spell/grammar checking functionality works properly in your web-system after the migration. Go to your web-system and check the controls where you expect to have spell/grammar checking.

4.2. Shut Down Old Server

Before asking for a new permanent license ticket, you must shut down the old server with another copy of the application and permanent license. And provide a formal confirmation that the old server is shut down. You are not allowed to run two servers under a single license. This will be considered as a severe breach of the WebSpellChecker Software License Agreement.

Above all that, you need to provide a zipped AppServer/Logs folder from your fresh installation of the application that is currently running with a temporary license. You can retrieve the Logs folder using one of the following ways below.

The location of Logs folder directly depends on the type of the environment where the WebSpellChecker application is installed and running.

  • Path to Logs folder on a Windows server:
/<WebSpellChecker_Installation_Path>/WebSpellChecker/AppServer/Logs
  • Path to Logs folder on a Linux server:
/<WebSpellChecker_Installation_Path>/WSC/AppServer/Logs

5. Activate Permanent License

Once you provided all the required information and proved that your old server is deprecated, the WebSpellchecker support team will issue a new permanent license ticket to you. Check the manual below, it will help you to replace your temporary license with a permanent one.

 Upgrading WebSpellChecker License from Trial to Permanent...



Good to know:

  • License Ticket ID is a special license activation key that is required for the WebSpellChecker application usage.
  • There are two types of License Ticket IDs available: 30-day trial and permanent (unlimited). Except the validity period, there is no difference between ticket types from the technical perspective.
  • WebSpellChecker license is hardware-based. Once the license is activated, it can't be reused again on another server.

Before you begin:

  • Make sure that you have a valid permanent License Ticket ID. If not, you can acquire a permanent license on the official webspellchecker.net website or contact our Sales department at info@webspellchecker.net.
  • Ensure that you are specified as one of the license owners. During the license activation procedure, you will receive an automated email with a License Response string that is required for the license confirmation.

This guide outlines the main steps that you are required to perform in order to upgrade from the 30-day evaluation license to a permanent one.

1. Stop AppSever

Before you start the license activation process, you are required to stop the WebSpellChecker Application Server (AppServer) that currently is running with a 30-day trial license. You can do it using one of the options considering the type of the environment where your copy of the WebSpellChecker application is installed.


Stop AppServer on a Windows server

There are three possible options how you can stop AppServer on Windows-based environments.

Option A: Go to Windows Start –> All Programs –> WebSpellChecker –> AppServer –> Stop WebSpellChecker Application Server

Option B: Open Command Prompt –> Switch to [WebSpellChecker_Installation_Path]/AppServer –> Run AppServerX -stop

Option C:

  • Go to Windows Start –> Control Panel –> Administrative Tools –> Services
  • Find WebSpellChecker Application Server Service on the list of all services
  • Click Stop


Stop AppServer on a Linux server

Run the stop.sh script to stop AppServer using the following command below:

sudo sh <WebSpellChecker_Installation_Path>/WSC/AppServer/stop.sh

Or your can also run the stop.sh script from the AppServer directory:

/<WebSpellChecker_Installation_Dir>/WSC/AppServer/# sh stop.sh

2. Activate License

As soon as AppServer is stopped, proceed with the license activation process according to one of the guides below.

3. Start AppServer

After you successfully completed all the steps described in the license activation manual, you need to start AppServer. 


Start AppServer on Windows

There are three possible options how you can start AppServer on Windows-based environments.

Option A: Go to Windows Start –> All Programs –> WebSpellChecker –> AppServer –> Start WebSpellChecker Application Server

Option B: Open Command Prompt –> Switch to [WebSpellChecker_Installation_Path]/AppServer –> Run AppServerX -start

Option C:

  • Go to Windows Start –> Control Panel –> Administrative Tools –> Services
  • Find WebSpellChecker Application Server Service on the list of all services
  • Click Start


Start AppServer on Linux

Run the start.sh script to start AppServer using the following command below:

sudo sh <WebSpellChecker_Installation_Path>/WSC/AppServer/start.sh

4. Verify License Status

 Click here to expand the license verification manual...


Good to know:

  • License Ticket ID is a special license activation key that is required for the WebSpellChecker application usage.
  • There are two types of License Ticket IDs available: 30-day trial and permanent (unlimited). Except the validity period, there is no difference between ticket types from the technical perspective.
  • WebSpellChecker license is hardware-based. Once the license is activated, it can't be reused again on another server.

You can verify a WebSpellChecker license type and its validity period by accessing one of the logs files under AppServer/Logs folder. By default the Logs folder contains Main.log and several child log files like Child_0.log, Child_1.log.

1. Logs Location

The location of Logs folder directly depends on the type of the environment where the WebSpellChecker application is installed and running.

  • Path to Logs folder on a Windows server:
/<WebSpellChecker_Installation_Path>/WebSpellChecker/AppServer/Logs
  • Path to Logs folder on a Linux server:
/<WebSpellChecker_Installation_Path>/WSC/AppServer/Logs

2. License Status

Open one of the logs files from Logs folder, find the records with license status information. Based on your license status, you may see the following messages.

Critical	License status: license is absent
Information	License status: 29 days remains
Error	    License status: expired
Information	License status: license is unlimited

The one of the logs files (Main.log, Child_0.log, Child_1.log) from the Logs folder should contain the following license status message for a permanent license:

Information License status: license is unlimited

As soon as you activated and verified the application under the permanent license, please provide us with a zipped AppServer/Logs folder again. This will help us to verify that a new permanent license is activated on the new server properly.