Caché Installation Guide
Installing Caché on Mac
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:
This section describes the hardware and software requirements for installations of Caché.
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
When installing Caché and Ensemble, a private version of Apache is installed to ensure that:
The Management Portal runs out of the box.
An out-of-the-box testing capability is provided for development environments.
The private Apache web server is not supported for any other purpose.
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.
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.
Obtain the Caché disk image file (with a .dmg
extension) from InterSystems and copy it to the system to be installed.
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.
For custom installation, choose any or all of the following components:
CSP Gateway (required to use the Management Portal and view Caché online documentation)
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.
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
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:
If you might want to configure autostart in the future, edit the file and find the following lines:
then change true
. To turn autostart on again, change the value back to true
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).
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
The alternative installation of Caché on the Mac OS X is much like the installation on any UNIX® platform.
Obtain the installation kit from InterSystems and install it on the desktop.
Log in as user ID root
. It is acceptable to su
(superuser) to root
while logged in from another account.
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:
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.
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.
administrator$ sudo sysctl -w kern.maxproc=2500
kern.maxproc: 2065 -> 2500
administrator$ sudo sysctl -w kern.maxprocperuid=2500
kern.maxprocperuid: 2000 -> 2500
administrator$ sysctl -a | grep maxproc
kern.maxproc = 2500
kern.maxprocperuid = 2500
Note, however, that 2500
is the absolute unchangeable upper limit.