Installing Caché on Mac

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:

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 macOS operating system on Intel. For macOS, the Caché Server Pages (CSP) technology is supported on the Apache and Nginx web servers. For current information, see the “Supported Technologies” chapter of the online InterSystems Supported PlatformsOpens in a new tab document for this release.

Note:

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.

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 the online InterSystems Supported PlatformsOpens in a new tab document for this release).

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.

Important:

For up-to-date information about platforms, versions, and features supported for each operating system, see the “Supported Technologies” chapter of the online InterSystems Supported PlatformsOpens in a new tab document for this release.

Caché UNIX® Installation

The installation of Caché on the macOS is much like the installation on any UNIX® platform.

To install Caché:

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.
See Adjustments for Large Number of Concurrent Processes and make adjustments if needed.
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.
For post-installation tasks and other information about Caché on macOS, see the Installing Caché on a UNIX® or Linux 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:

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.
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.
- System-wide process limits — The kern.maxproc, kern.maxprocperuid parameters are set to 532 and 100 by default. You can change them using the following commands:
```
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.