vqServer: Upgrading


This page tells you how to upgrade from vqServer version 1.01 to version 1.03.

There are a number of fundamental differences between these two versions which means that:

  • The organisation of the default website directory and some file names have changed.
  • The internal format of the configuration files have changed. Unfortunately, version 1.01 configuration files cannot be read by version 1.03. vqSoft undertakes to ensure that future versions will be able to read version 1.03 configuration files.
  • The servlet interface supported has changed from version 1.0 to version 1.01.

The following steps are recommended:

  1. Obtain updated versions of or modify any important servlets you use. Version 1.0 servlets will not work with vqServer version 1.03. The most important change here is that the servlet interface is now defined in the javax.servlet packages instead of the java.servlet package.
  2. Obtain and install current versions of the Java Runtime Interpreter (JRE) and any Java performance-enhancing measures such as just-in-time compilers available for your hardware and operating system, following their suppliers' instructions. This will make a big difference to vqServer's speed of operation.
  3. Stop vqServer.
  4. Back up your vqServer configuration and log files.
  5. Extract the vqServer distribution archive vqserver.zip to a temporary directory, making sure that the directory structure and long file names in the archive are preserved. If this step is successful, the temporary directory will include a number of subdirectories and a file named readme.html.
  6. Delete the vqserver subdirectory of your existing website directory.
  7. Copy the vq subdirectory and the servlets subdirectory from the temporary directory to your website directory.
  8. Copy the classes.zip file from the classes subdirectory in the temporary directory to website/classes, overwriting the old classes.zip.
  9. Follow the instructions on the Startup page of this documentation to start vqServer (there are some important but subtle differences in startup procedures between versions 1.01 and 1.03).
  10. Start the vqServer control centre using the URL http://localhost:9090. Use user ID admin and password admin.
  11. Change the administrator password and use the control centre to make any other necessary configuration changes.


vqServer version 1.03. Copyright © 1997-98 vqSoft and Steve Shering. Last updated 13 May 1998.

vqServer
Register (free!)
Support

Contents

Installation
Startup