Upgrading an existing Active Worlds server

This page contains instructions for upgrading an existing Active Worlds server to the latest version.

We recommend making a complete backup of your world server folder before upgrading in case of any unexpected mishaps!

Upgrading from version 2.0 or later

  1. Download the latest version of the Active Worlds Server.
  2. Make sure your world server is not running.
  3. Under Windows, double-click on the install program to install the new server. Under Unix, use the tar command to extract the archive. On both systems, you should install the new server executables on top of your existing world server installation.
  4. Restart your world.

Note that it is not necessary to run the convert script when upgrading from 2.0.

Upgrading from version 1.3 or earlier

  1. Download the latest version of the Active Worlds Server.
  2. Make sure your world server is not running.
  3. Under Windows, double-click on the install program to install the new server. Under Unix, use the tar command to extract the archive. On both systems, you should install the new server executables on top of your existing world server installation.
  4. Run the conversion script. Under Windows this is the file convert.bat; under Unix it is called convert. This will automatically convert your old world data files to work with the new version. This script assumes that your world.ini and database files are in the same directory as the executables. If you are using some other arrangement of the files then you should probably do the upgrade by hand.

    The conversion script carries out the following steps:

    • All database files (*.dat and *.idx) are copied to a "backup" subdirectory first.
    • The old database is dumped to the text file "pdump.txt" using propdump. This is the latest version of the propdump utility which knows how to dump all versions of world databases. The format of the resulting "pdump.txt" is only suitable for loading with the new propload utility regardless of the format of the original world.
    • "pdump.txt" is loaded using propload.
  5. Restart your world.

Note: the old 1.3 utilities propadd and propstat are obsolete and should not be used after upgrading!