Home > Books > Errata > Advanced JavaT 2 Platform How to Program > Cloudscape 3.6
Installation Instructions for Cloudscape 3.6
This page explains how to install Cloudscape 3.6. using the
zip-based installation package. More information about installing and using
Cloudscape on a variety of Java platforms can be found at:
http://www-3.ibm.com/software/data/cloudscape/
To connect to a database created with a
version of Cloudscape prior to 3.6, Cloudscape must upgrade that database.
Upgrading involves writing changes to the system tables and so is not possible
for databases on read-only media. Please read the user documentation for
important information on upgrading your databases.
DO NOT INSTALL Cloudscape 3.6.4 on top of an existing pre-3.6 installation.
Uninstall prior versions of the product by running the uninstall program, or
manually removing the files. The uninstaller will not remove your databases.
You need approximately 21.5MB of free disk
space to complete installation of Cloudscape 3.6.
Installation to a path containing spaces is not supported in Cloudscape 3.6.
To install:
- Create a directory for the Cloudscape product, i.e., Cloudscape_3.6
- Locate a program capable of unpacking files in the zip format in order to extract the files contained in cloudscape364.zip. It is hightly recommended that you use a tool that supports end-of-line (EOL) character translation. For example, the unzip command found on most UNIX systems will do this with the '-a' flag. Most implementations of the JAR (Java Archive) utility do not have a flag that performs EOL character translation. In these cases you may encounter problems deploying Cloudscape 3.6.4
- Copy the cloudscape364.zip file to the directory into which you wish to install, and execute the command to extract all the contents of the zip archive. This will vary according to which tool you use, but the command-line format for using unzip would be: unzip -a cloudscape364.zip
- Move the original cloudscape364.zip to some archived location. It is not needed to run the product.
Because the zip files are created
using Java's zip libraries, they do not contain information about file
permissions. You may find that using Jar to extract the files is more convenient
than using an unzip utility. On systems with strict file permission accounting,
the 'execute' bit may not be set on directories when using unzip, which usually
means that you cannot change directory into any of the directories that were
extracted from the zip file. In these cases, you will need to change the
permissions of the files manually, with a utility such as chmod. On some
systems, it is possible to set the default file permissions for new files, as
with 'umask' in shell programs such as ksh, to prevent this problem.
Once you've installed the product, please review the
release_notes.html file carefully for important information. You should also
review the book Getting Started with Cloudscape in the user documentation
(accessible from the index.html page located in the directory into which you
installed Cloudscape 3.6.). This information is especially important in helping
you understand how to get successfully started with Cloudscape 3.6.
For information about Cloudscape technical support, visit: www.cloudscape.com/support/.