Main Content

mcr-root

Location of a MATLAB Runtime installation

Syntax

--mcr-root path

Description

mcr-root specifies the path to a MATLAB® Runtime installation on a system that has a MATLAB Production Server™ installed.

You can configure a server instance to use multiple MATLAB Runtime versions by specifying multiple mcr-root properties. To do so, specify the mcr-root property with the path to each MATLAB Runtime installation on a separate line, starting from the latest version to the oldest. The server instance scans the list of specified mcr-root properties in order from first to last, then chooses the first MATLAB Runtime installation capable of processing a server request. A MATLAB Runtime installation can process a server request if it is compatible with the deployable archive containing the MATLAB function being evaluated. When you configure the server to use multiple MATLAB Runtime versions, the server uses dynamic worker pool management, where it starts the worker processes in response to demand, and stops them in response to system resource utilization. Specifying multiple MATLAB Runtime installations of the same version has no effect on server performance.

Note

An installation of MATLAB Production Server supports MATLAB Runtime versions up to six releases back.

Note

  • Specify the path to a MATLAB Runtime installation on a local file system when configuring a server instance. Specifying a path on network partition might cause worker processes to fail.

  • All values for mcr-root must be for the same operating system and hardware combination.

For a server environment deployed in the Cloud, the deployment sets the mcr-root property to support multiple MATLAB Runtime versions.

Parameters

path

Path to the root folder of the MATLAB Runtime installation.

Note

The special value mCRuNsETtOKEN indicates to the mps-start command that a server is not configured to use a MATLAB Runtime. Running the mps-start command without configuring MATLAB Runtime results in an error.

Examples

Use the latest version of the MATLAB Runtime.

--mcr-root /usr/local/MATLAB/MATLAB_Runtime/v910

Use two versions of the MATLAB Runtime.

--mcr-root /usr/local/MATLAB/MATLAB_Runtime/v910
--mcr-root /usr/local/MATLAB/MATLAB_Runtime/v98