Caché Installation Guide - InterSystems Documentation

Installing Caché on OpenVMS
• Installs the Caché system manager databases.
• Starts Caché in installation mode.
• Installs Caché system manager globals and routines.
• Shuts down Caché and restarts using the default configuration file. Upgrade installations restart
using their original configuration files, updated as necessary.
To perform the installation:
1. Start the installation procedure by running the CINSTALL script, located at the top level of the
installation files:
@CINSTALL
Or, if you are not in the installation directory, use a full path to invoke the script, such as:
@DKA0:[CACHEKIT.2008-2-0-250-0]CINSTALL
Where, in this case, DKA0:[CACHEKIT.2008-2-0-250-0] specifies the directory path where you
uncompressed and stored the installation kit distribution files.
2. The installation script displays a list of any existing Caché instances on this machine. At the
prompt, enter an instance name. If an instance with this name already exists, the program asks if
you wish to upgrade it. If no such instance exists, it asks if you wish to create it and asks you to
specify its location on disk. If the directory you specify does not exist, it asks if you want to create
it. The default answers are Yes; press Enter to continue with the installation.
3. You next are asked if you want to install Caché with 8-bit or Unicode character support.
InterSystems recommends 8-bit character support for locales based upon the Latin-1 character
set, ISO 8859–1. Use Unicode if the base character set for your locale is not Latin-1, or if you
plan to have data from locales based upon a different character set. If you use an 8-bit version of
Caché, your data is not portable to 8-bit locales based on a different character set.
CAUTION:
If you choose a Unicode installation, you cannot revert to an 8-bit version without
potential data loss. This is because an 8-bit version of Caché cannot retrieve 16-
bit character data from a database.
4. The script then asks if you wish to load the source code for the various system management utilities
and load the Caché engine link libraries, which are used for building custom callin and callout
modules. The default options, , are appropriate for these prompts in most cases.
5. You next decide how restrictive you want the initial Caché security settings to be. Choose from
Minimal (1), Normal (2), and Locked Down (3). The default is Minimal; if you choose this, the
installation continues with the next step.
If you enter 2 or 3, the script asks for additional information:
30 Caché Installation Guide