vqServer Upgrading


This page contains instructions for upgrading from:

Version 1.8 to version 1.9

A special distribution archive upgrade.zip containing the new classes.zip, Windows executable and documentation is available and should be used instead of the main vqserver.zip distribution archive. The upgrade.zip archive and these instructions assume that you are using the default directory structure supplied in your original vqserver.zip. The upgrade process will not affect your existing web pages or vqServer configuration. To upgrade:

  1. Stop vqServer.
  2. Extract the upgrade.zip distribution archive to your website/ directory. This will overwrite a number of files.
  3. Restart vqServer.

Version 1.06 to version 1.9

A special distribution archive upgrade.zip containing the new classes.zip, Windows executable and documentation is available and should be used instead of the main vqserver.zip distribution archive. The upgrade.zip archive and these instructions assume that you are using the default directory structure supplied in your original vqserver.zip. The upgrade process will not affect your existing web pages or vqServer configuration. To upgrade:

  1. Stop vqServer.
  2. Extract the upgrade.zip distribution archive to your website/ directory. This will overwrite a number of files.
  3. Restart vqServer.

Version 1.03 to version 1.9

Before starting, please read the important changes section in the version history. Version 1.9 can read version 1.03, version 1.04, version 1.05, version 1.06 and version 1.07 configuration files (note that this compatibility is forwards only), so upgrading is straightforward. However, amending your existing configuration to use version 1.9 features (such as the file upload servlet) is not so easy, so you may wish to start afresh with version 1.9 in a new directory to try out these features. To upgrade:

  1. Stop vqServer.
  2. Extract the new vqserver.zip distribution archive to a temporary directory.
  3. Copy classes/classes.zip from the temporary directory to website/classes/classes.zip, overwriting the existing classes.zip.
  4. Delete the contents of website/vq/server/icons/ and replace it with the contents of the same directory in the temporary directory.
  5. Delete the contents of website/vq/server/docs/ and replace it with the contents of the same directory in the temporary directory.
  6. Create an empty subdirectory of website/vq/server/ named sessions/.
  7. Restart vqServer.
  8. To use the file upload facility you need to create a directory for uploads, create an alias for the file upload servlet and specify initialisation parameters for the servlet. See the file upload page for more information.

Version 1.01 to version 1.9

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.9.
  • The servlet interface supported has changed from version 1.0 to version 2.0.

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.9. 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 Virtual Machine (JVM) 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 main 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 version 1.01 and version 1.9).
  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.9. Copyright © 1997-2000 Steve Shering and vqSoft. Last updated 2 July 1999.

vqServer
FAQs
Register (free!)
Support

Contents

Installation
Startup