Caché Installation Guide
Installing Caché on Mac
[Back] [Next]
Go to:

This chapter describes how to install Caché on a Apple Mac OS X system. It assumes that you are familiar with Mac directory structures, utilities, and commands. This chapter contains the following major sections:

Installation Requirements
This section describes the hardware and software requirements for installations of Caché.
Disk Space Requirements
A standard Caché installation that includes support for Caché Server Pages (CSP), needs approximately 1 GB (gigabytes) of disk space depending on the type of installation you choose.
Supported Platforms and Web Servers
The latest version of Caché is supported on the Apple Mac OS X operating system on Intel. For Mac OS X, the Caché Server Pages (CSP) technology is supported on the Apache and Nginx web servers. For current information, see the “Supported Technologies” chapter of InterSystems Supported Platforms.
When installing Caché and Ensemble, a private version of Apache is installed to ensure that:
  1. The Management Portal runs out of the box.
  2. An out-of-the-box testing capability is provided for development environments.
The private Apache web server is not supported for any other purpose.
For deployments of http-based applications, including CSP, Zen, and SOAP over http or https, you should not use the private web server for any application other than the Management Portal; instead, you must install and deploy one of the supported web servers (for information, see “Supported Web Servers” in the “Supported Technologies” chapter of InterSystems Supported Platforms).
If using CSP, you must install the web server before installing Caché for the installation to configure the web server. Its support on each operating system is dependent on the operating system vendor and is subject to change. See the Web Server Configuration section of the “CSP Configuration” chapter of the Using Caché Server Pages guide for more information.
For up-to-date information about platforms, versions, and features supported for each operating system, see the “Supported Technologies” chapter of InterSystems Supported Platforms.
Caché Installation
In most cases, Caché installation is much like installing other software products on the Mac operating system and does not require an archive file. However, installation using the Apple disk image (.dmg) file, as described in the following procedure, is intended only for single instance environments, and does not allow for customization of the installation directory or other installation options. For cases in which you are installing multiple instances of Caché on one machine or want to use installation options, see the Caché UNIX® Installation section for detailed instructions.
  1. Obtain the Caché disk image file (with a .dmg extension) from InterSystems and copy it to the system to be installed.
  2. Double-click the image file (for example, Cache_macx64_2014. to open a Finder window.
  3. The Finder window displays the Cache.pkg file and the Release Notes” directory. Double-click Cache.pkg to open the Install Caché dialog, then click Continue on the Welcome to Caché Installer window to begin the Caché installation.
  4. You must click Agree on the Caché Software License Agreement window to accept the license agreement before you can continue with the installation procedure.
  5. On the Standard Install on Macintosh HD” window, click Continue; do not change the location of the installation.
  6. On the same window, choose the installation type by selecting Install for standard installation or Customize for custom installation. If you select standard installation, please proceed to step 9.
  7. For custom installation, choose any or all of the following components:
    Clicking Standard Install installs all the components. If you plan to use this node only as a client, you may not need to install the Caché Server.
    If there is no existing instance of Caché on this machine, this is a new install, otherwise it is an upgrade.
  8. Select components and click Install to install selected components, or click Standard Install and then Install to install all components.
  9. Installation begins after asking you to authenticate, ensuring that you have the correct privileges to install Caché. Enter your name and password and click OK.
  10. As the installation completes, you see various messages with a progress bar and finally the Software installed successfully message. The installer places Caché in the /Applications/Cache folder and runs from port 1972 or the first available subsequent number equal to or higher than 56773. It names the instance CACHE. Caché starts when the installation completes.
    Caché also installs scripts into /Library/StartupItems/Cache to start Caché on OS startup and to allow you to start, stop, and restart Caché using the Mac OS X built-in service utilities.
Changing the Autostart Configuration
Caché installation on Mac OS X creates a launchd daemon that launches the Caché instance at system boot. This is done by installing the com.intersystems.cache.plist configuration file in /Library/LaunchDaemon. If you want the Caché instance to autostart (start when the system starts), do nothing. If you want to change the configuration, you have the following options:
Caché is configured to autostart on Mac OS X only when installed using the .dmg file, and not when installed using the UNIX® procedure (see Caché UNIX® Installation).
Using the Management Portal
You can manage your Caché instance using the Management Portal, which is accessible from your web browser; go directly to the Management Portal URL: http://machine:port/csp/sys/UtilHome.csp, where machine is the IP address of your system (such as localhost) and port is the port number of the private web server installed by Caché, (defaults to port 57772 or the first available subsequent number).
For example, the default location on the local server of a single installation of Caché is http://localhost:57772/csp/sys/UtilHome.csp.
For more information on this management tool, see the Using the Management Portal chapter of the Caché System Administration Guide.
Uninstalling Caché
To uninstall a Caché instance that was installed with the Mac OS X installer, perform the following from the terminal as root:
cd /Applications/Cache      ; ./cstop
rm -rf /Applications/Cache
pkgutil --forget com.intersystems.cache.cspgateway 
pkgutil --forget com.intersystems.cache.development 
pkgutil --forget com.intersystems.cache.odbc 
pkgutil --forget com.intersystems.cache.server 
pkgutil --forget com.intersystems.iscagent
ccontrol delete Cache
Caché UNIX® Installation
The alternative installation of Caché on the Mac OS X is much like the installation on any UNIX® platform.
To install Caché:
  1. Obtain the installation kit from InterSystems and install it on the desktop.
  2. Log in as user ID root. It is acceptable to su (superuser) to root while logged in from another account.
  3. See Adjustments for Large Number of Concurrent Processes and make adjustments if needed.
  4. Follow the instructions in the Run the Installation Script section and subsequent sections of the “Installing Caché on UNIX and Linux” chapter of this guide.
Adjustments for Large Number of Concurrent Processes
Make the following adjustments if you are running a system that requires a large number of processes or telnet logins:
  1. Remote connections — The number of pty (pseudo terminal) connections is limited to 128 system-wide. If your applications count on telnet or other pty-using connections for users to access, keep this in mind.
  2. Number of processes — If the pty limit is not a problem, but you need to run a larger number of processes, there are limits to that as well.