Caché Installation Guide
About This Book
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 http://www.intersystems.com/atelier
, the Atelier home page.
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:
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:
The installation directory of a Caché instance cannot be changed following installation.
On Windows, OpenVMS, UNIX®, and Linux systems, you must select either 8-bit or Unicode support for your installation:
The software handles characters in an 8-bit format.
The software handles characters in the Unicode (16-bit) format. Select Unicode if your application uses languages that store data in a Unicode format, such as Japanese.
InterSystems recommends 8-bit character support for locales based upon the Latin-1 character set, ISO 88591. 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