Documentation Center

Upgrading WorldServer

When you upgrade to a newer version of WorldServer, your users will not have access to the program for a certain period of time. You need to plan that period in advance and inform users before you upgrade.

About this task

You should first perform the upgrade procedure on a staging system, and then use that system to test the new functionality before actually upgrading your production system. A full upgrade of WorldServer also involves changing the underlying database schema.

This procedure describes a basic WorldServer upgrade. For information about upgrading in clustered mode, see the "Upgrading WorldServer in clustered mode" topic.

Procedure

  1. Install the supported version of the Java JDK.
  2. Download the version of WorldServer that you want to upgrade to from the WorldServer distribution site.
  3. Stop WorldServer.
    You can stop and start WorldServer from the application server on which it is deployed.
  4. Back up the appropriate files and components, including the WS_CONFIG folder.
  5. Set the appropriate environment variables, including JAVA_HOME, WS_HOME, WS_CONFIG, as well as variables specific to the application server.
  6. Test the current database schema, and then upgrade the WorldServer database schema.
  7. If you are not using the WorldServer installer to install Apache Tomcat and the Java Runtime Environment, make sure you have the supported Tomcat and Java Runtime Environment versions installed.
  8. Upgrade the WorldServer software.
    Perform this step only once, regardless of the version you are starting from.
  9. Validate your upgrade.

Results

You have finished upgrading WorldServer. You can now start WorldServer and verify that the program works as expected.