This chapter describes how to install Caché on a macOS 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.
The installation of Caché on the macOS 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.