Main Content

mps-new

Create server instance from command line on Windows, Linux, and macOS systems

Syntax

mps-new [path/]server_name [-v] [--service] [--service-name name] [--service-description description] [--service-user user] [--service-password password] [--noprompt]

Description

mps-new [path/]server_name [-v] [--service] [--service-name name] [--service-description description] [--service-user user] [--service-password password] [--noprompt] makes a new folder at path and populates it with the default folder hierarchy for a server instance.

Input Arguments

path

Path to server instance.

server_name

Name of the server instance to create.

If you are creating a server instance in the current working folder, you do not need to specify a full path; specify only the server name.

-v

Display the status of each folder in the file hierarchy created to form a server instance

--service

On Windows®, register the server instance as a Windows service.

The Windows service default settings are:

  • Service Display Name: MATLAB Production Server – path\server_name

  • Service Description: MATLAB Production Server running instance path\server_name

  • Service User: LocalSystem

The Windows service is configured to start when the machine starts, not at creation of the service. After you have made configuration changes, start the server instance using mps-start.

--service-name name

Display name for the Windows service associated with the server instance

--service-description description

Informational statement describing the Windows service associated with the server instance

--service-user user

Windows account under which the service associated with the server instance should run. The user account must have read, write, and, delete permissions for the instance directory as well read and execute permissions for the MATLAB® Production Server™ installation directory.

--service-password password

Password for the service user account

--noprompt

Indicates that no prompts are generated

Examples

expand all

To create a new server instance, and display the status of each folder in the file hierarchy as the server instance is created, type the following at the system command prompt:

mps-new /tmp/server_1 -v
server_1/.mps-version...ok
server_1/config/...ok
server_1/config/main_config...ok
server_1/endpoint/...ok
server_1/auto_deploy/...ok
server_1/.mps-socket/...ok
server_1/log/...ok
server_1/pid/...ok

To create a new server instance, and register it as a Windows service, type the following at the Windows command prompt:

mps-new /tmp/server_1 --service

Tips

  • Before creating a server instance, ensure that no file or folder with the specified path currently exists on your system.

  • After issuing mps-new, issue mps-start to start the server instance.

Version History

Introduced in R2012b