Upgrading WorldServer in clustered mode

About this task

When upgrading a WorldServer cluster, some steps needs to be performed on each node, while other steps need only be performed once.
  • You need to run the schema upgrade SQL script only once, from one of the nodes. You also need to run the wsupgrade script (which upgrades WorldServer objects) only once. Note that this information does not apply to WorldServer 10.2.

Procedure

  1. Download the latest version of the distribution kit on a central WorldServer node.
  2. Back up the WS_CONFIG folder from each node.
    Thus, you will be able to restore your configurations if your data ever becomes corrupted. Also, make sure that all the custom properties you have set are in the WS_CONFIG folder.
  3. Run testschema.sh (Linux) or testschema.bat (Windows).
  4. Upgrade the database from the first server.
    This is the only schema upgrade you need to perform.
  5. On the first server application, install the new WorldServer software and, if WorldServer requires a new version, install new versions of Java and Apache Tomcat.
  6. If relevant, run wsupgrade.sh (Linux) or wsupgrade.bat (Windows) from the first server to complete Java-based upgrades of WorldServer objects.
  7. Run the testschema.sh (Linux) or testschema.bat (Windows) testing script to verify the database schema upgrade.
  8. Start WorldServer on the first application server and check that it is working properly.
  9. On each subsequent machine, install the new WorldServer software and, if WorldServer requires a new version, install versions of Java and Apache Tomcat.
  10. Check if any new configuration properties have been introduced in the current release and specify values for them in the WS_CONFIG folder.
  11. Start all instances and test the newly upgraded installation.