CrayDoc™ Installation and Administration Guide
6.6 Upgrading from version 1.0
This section guides you through the process of upgrading your CrayDoc server
software from version 1.0 to 2.0.
The safest way to upgrade your server software is to rename your existing
CGI and HTML directories (the values of $ScriptAlias and $DocumentRoot,
respectively) and create new directories for your 2.0 files with the same names as
the old directories. You can then test the installation, and if necessary, revert to
the old (1.0) directories if you enounter problems with the new 2.0 installation.
Using this method, the URL remains the same for your users.
!
Caution: Several of the installed CrayDoc 2.0 files require hard-coded path
values, which the install script automatically performs for you. If you
install CrayDoc manually, you must edit these files by hand. The values that
require hard-coded paths are indicated with an HTML comment tag: <!--
somevalue -->, where somevalue is an absolute path. The path values depend
on your craydoc-config configuration. The files that require these values
are: craydoc.cgi, glossary.cgi, manpage_display.cgi in $ScriptAlias,
all the administration tools (including cdadmin), and the main index.html
file in $DocumentRoot.
You should have a copy of your existing 1.0 craydoc-config file available for
reference.
Procedure 1: Upgrading to CrayDoc 2.0
1. Rename your existing $ScriptAlias and $DocumentRoot directories.
Example 1:
prompt> mv /var/www/docs /var/www/docs.10
prompt> mv /var/www/cgi-bin /var/www/cgi-bin.10
2. Create new directories with the same names as your old $ScriptAlias and
$DocumentRoot directories.
Example 2:
prompt> mkdir /var/www/docs
prompt> mkdir /var/www/cgi-bin
3. Mount the CrayDoc CD, and install the 2.0 software with the install
script. When prompted, be sure to use the same directory values that
you used for your 1.0 installation. For more information about the install
process, see Section 4.2, page 16.
30 S–2340–21
