Previous Next Up FAQ Table of Contents

3.2 Upgrading VolanoChat

Upgrading versions

The latest release of VolanoChat is version 2.5, with several important new features and bug fixes. You can download the latest version of VolanoChat from the Download VolanoChat page.

There have been significant changes to the property files for VolanoChat from previous versions. We strongly recommend that you complete a clean install and then modify the property files according to the documentation. The time spent doing this will usually be much less than the time spent tinkering with the VolanoChat server trying to figure out what old property value is giving you trouble. However, if you want to use your existing property files, you will need to take the following steps:

  1. Install the update.
  2. Copy your server configuration.
  3. Copy your applet configuration.
  4. Update your properties.
  5. Restart the server.
  6. Request a new key.

General instructions

Step 1 - Install the update

Install the new version of VolanoChat into its own directory, vchat2.5.1.x by default, where x is the arbitrary build number.

Step 2 - Copy your server configuration

Copy the server configuration files from the older VolanoChat 2.1 directory to the new installation's conf subdirectory. For example, on Unix enter a command like the following:

cp vchat2.1.10.2/*.txt vchat2.5.1.x/conf

and on Windows, enter:

copy vchat2.1.10.2\*.txt vchat2.5.1.x/conf

On Windows, you may instead use the Windows Explorer to drag and drop these files from your old vchat2.1.10.2 folder to the new vchat2.5.1.x/conf folder.

Step 3 - Copy your applet configuration

Do the same for your applet configuration files, along with any image, sound, or Web files you have modified. For example, on Unix enter commands like the following:

cp vchat2.1.10.2/vcclient/*.txt  vchat2.5.1.x/webapps/ROOT/vcclient
cp vchat2.1.10.2/vcclient/*.gif  vchat2.5.1.x/webapps/ROOT/vcclient
cp vchat2.1.10.2/vcclient/*.jpg  vchat2.5.1.x/webapps/ROOT/vcclient
cp vchat2.1.10.2/vcclient/*.au   vchat2.5.1.x/webapps/ROOT/vcclient

and on Windows, enter:

copy vchat2.1.10.2\vcclient\*.txt  vchat2.5.1.x\webapps\ROOT\vcclient
copy vchat2.1.10.2\vcclient\*.gif  vchat2.5.1.x\webapps\ROOT\vcclient
copy vchat2.1.10.2\vcclient\*.jpg  vchat2.5.1.x\webapps\ROOT\vcclient
copy vchat2.1.10.2\vcclient\*.au   vchat2.5.1.x\webapps\ROOT\vcclient

where x is the build number you downloaded.

On Windows, you may instead use the Windows Explorer to drag and drop these files from your old vchat2.1.10.2/vcclient folder to the new vchat2.5.1.x\webapps\ROOT\vcclient folder. If you have published the old vcclient directory through your Web server, make sure to remove it and publish the new vcclient folder. You cannot use the version 2.1 applets with the version 2.5 server.

Step 4 - Update your properties

You'll want to update your older property files to include the new server and applet properties available in the latest version. The first thing you should modify is the server.rooms property in conf/properties.txt so that it points to the new location of the rooms.txt file. Otherwise the server will fail to start:

server.rooms=conf/rooms.txt

Step 5 - Restart the server

Stop the VolanoChat server and restart the new version in the vchat2.5.1.x directory. See the [4.0] Installation chapter for details on how to start and stop the VolanoChat server for your operating system.

Step 6 - Request a new key

VolanoChat version 2.5 uses a new text-based license key. Your old 2.1 license key will not work. If you're upgrading to version 2.5 from a pervious version, you will need to write to Volano Support <support@volano.com> for details on how to obtain a new key. Once you receive this key, copy it into your conf/key.txt file over the existing trial key file. Make sure the license string itself is on just one line in the file and not word-wrapped onto one or more lines. Then restart the VolanoChat server.


Previous Next Up FAQ XHTML 1.0 Table of Contents