Caché Installation Guide
About This Book
Go to:

Caché runs on several different platforms. Please check InterSystems Supported Platforms to verify that Caché runs on your particular version of the supported operating systems.

The Caché Installation Guide contains the following chapters and related appendixes.
If you are upgrading from Caché version 5.1 or later, read the following chapter for a list of pre-installation upgrade tasks:
Install Caché following the instructions in the appropriate platform-specific installation chapter:
Before installing, review the material in the appropriate platform-specific appendix for setting operating system parameters:
You may need to read the following appendixes before you install Caché if they apply to your environment:
Read the appendix Creating and Using an Installation Manifest to learn how to create an installation manifest describing a specific Caché configuration and use it to generate code to configure a Caché instance.
For detailed information, see the Table of Contents.
For general information, see Using InterSystems Documentation.
The InterSystems products Caché and Ensemble share similar underlying technologies. Both products use the instructions in this book for installation. However, there are additional tasks for Ensemble, especially after the initial software installation is complete. Consult the Ensemble Release Notes for an overview of these tasks before beginning an Ensemble installation.
Caché Installation Directory
Throughout the Caché documentation, the directory in which a Caché instance is installed is referred to as install-dir. This directory varies by platform, installation type, and user choice, as shown in the following table:
Installation Type
C:\InterSystems\Cache (or CacheN when multiple instances exist) unless installing user specifies otherwise.
unattended C:\InterSystems\Cache (or CacheN when multiple instances exist) unless INSTALLDIR property specifies otherwise.
UNIX®, Linux
Installing user must specify.
ISC_PACKAGE_INSTALLDIR parameter required.
non-root Contents of required CACHESYS environment variable.
Single instance installation, always /usr/cachesys.
Single instance installation, always /Applications/Cache.
Installing user must specify.
Caché Character Width
On Windows, OpenVMS, UNIX®, and Linux systems, you must select either 8-bit or Unicode support for your installation:
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 anticipate handling 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.
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.
If you are installing Ensemble, you must select Unicode.
Configuring Third-Party Software
InterSystems products often run alongside and interact with non-InterSystems tools. For important information about the effects these interactions can have, see the appendix Configuring Third-Party Software to Work in Conjunction with InterSystems Products in the Caché System Administration Guide.