Upgrading WorldServer in clustered mode

When upgrading a WorldServer cluster, you need to perform some steps on each node, but there are also other steps that you need to perform only once. For example, you need to run the database schema upgrade script only once, from one of the nodes. You also need to run the wsupgrade script (which upgrades WorldServer objects) only once.

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 the testschema.sh (on Linux) or testschema.bat (on Windows) script to make sure that there are no errors in your current database.
  4. Upgrade the database of the first server.
    This is the only schema upgrade that you need to perform.
  5. On the first server, upgrade the WorldServer software.
    You might need to install new versions of Java and Apache Tomcat as well.
  6. If necessary, run wsupgrade.sh (on Linux) or wsupgrade.bat (on Windows) on the first server to complete Java-based upgrades of WorldServer objects.
  7. Run testschema.sh (on Linux) or testschema.bat (on Windows) to verify the upgrade of the database schema.
  8. Start WorldServer on the first application server and check if it is working properly.
  9. On each subsequent machine, upgrade the WorldServer software and, if necessary, install new 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 of WorldServer and test the newly upgraded environment.