Migrating data from the database

As a result of replacing the business rule applet in WorldServer 11.5, several changes have been made to the structure of the data stored in the WorldServer database. Therefore, after upgrading your WorldServer software to version 11.5 or later, you must run a data migration tool to make sure that your data is stored appropriately.

About this task

The tool that performs the data migration is stored in a .zip archive that is provided as part of the WorldServer distribution kit: ws-data-upgrade-<ws-version>.zip

Procedure

  1. Go to the WorldServer distribution kit and copy the ws-data-upgrade-<ws-version>.zip file to your local machine.
  2. Extract the contents of the ws-data-upgrade-<ws-version>.zip file to a path of your choice.
    Throughout the rest of the topic, this path will be referred to as <tool-location>.
  3. Go to <tool-location> and do one of the following:
    • On Windows, run the following command: run_upgrade.bat version <ws-version> config <WS_CONFIG>
    • On Linux, run the following command: run_upgrade.sh version <ws-version> config <WS_CONFIG>
    These commands involve two parameters:
    • version: Specifies the WorldServer version from which you are upgrading. For example, if you are upgrading from WorldServer 11.4.1, replace <ws-version> with 11.4.1.
    • config: Specifies the path to the location of the WorldServer configuration files. This parameter is optional. If you do not provide it, the tool will attempt to resolve it from the WS_CONFIG environment variable.
  4. Go to <tool-location>/logs and check the logs that the tool generated to make sure that the data migration process was successful.

What to do next

Upgrade your WorldServer software, and then validate your upgrade.