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.

With the release of version 2016.2, InterSystems introduces Atelier, a new IDE based on the open-source Eclipse development environment. Atelier is in active development and will provide a full Caché development environment in the future. Caché Studio remains available for customers with experience and investment in that technology.
Atelier is available as a separate download in addition to Caché or Ensemble. You can choose to install either a stand-alone Rich Client Platform (RCP) application, or a plug-in that can be added to an existing Eclipse installation. Users of the RCP application can add additional Eclipse plug-ins. Atelier uses the Eclipse auto-update mechanism to help users get the latest changes. For information on downloading Atelier and for the Atelier documentation, see, the Atelier home page.
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.
The installation directory of a Caché instance cannot be changed following installation.
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.