vqServer Upgrading
This page contains instructions for upgrading from:
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:
-
Stop vqServer.
-
Extract the upgrade.zip distribution archive to your website/
directory. This will overwrite a number of files.
-
Restart vqServer.
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:
-
Stop vqServer.
-
Extract the upgrade.zip distribution archive to your website/
directory. This will overwrite a number of files.
-
Restart vqServer.
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:
-
Stop vqServer.
-
Extract the new vqserver.zip distribution archive to a temporary
directory.
-
Copy classes/classes.zip from the temporary directory to
website/classes/classes.zip, overwriting the existing
classes.zip.
-
Delete the contents of website/vq/server/icons/ and replace it with
the contents of the same directory in the temporary directory.
-
Delete the contents of website/vq/server/docs/ and replace it with
the contents of the same directory in the temporary directory.
-
Create an empty subdirectory of website/vq/server/ named
sessions/.
-
Restart vqServer.
-
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.
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:
-
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.
-
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.
-
Stop vqServer.
-
Back up your vqServer configuration and log files.
-
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.
-
Delete the vqserver subdirectory of your existing website
directory.
-
Copy the vq subdirectory and the servlets subdirectory from
the temporary directory to your website directory.
-
Copy the classes.zip file from the classes subdirectory in
the temporary directory to website/classes, overwriting the old
classes.zip.
-
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).
-
Start the vqServer control centre using the URL
http://localhost:9090. Use user ID admin and password
admin.
-
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 |