mps-service
Create or modify Windows service for server instance from command line on Windows systems
Syntax
Description
mps-service [-C [
creates a Windows® service for the server instance.path
\]server_name
]
create [--name name
] [--description description
]
[--user user
] [--password password
]
[--noprompt]
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
.
mps-service [-C [
updates the Windows service entry for the server instance.path
\]server_name
]
update [--name name
] [--description description
]
[--user user
] [--password password
]
[--instance-root new_path
] [--noprompt]
mps-service [-C [
deletes the Windows service entry for the server instance. If you use the dashboard to
create and start server instances, do not use path
\]server_name
]
deletemps-service
to
delete server instances.
mps-service delete
deletes the Windows service entry by name. If you use the dashboard to create and
start server instances, do not use service_name
[[--force]|[-f]]mps-service
to delete
server instances.
mps-service clean [[--force]|[-f]][[--verbose]|[-v]]
deletes
invalid Windows service entries.
Invalid Windows service entries are entries where either the target version of MATLAB® Production Server™ is not present or the associated server instance no longer exists.
mps-service [-C [
restores the deleted Windows service entry for the server instance.path
\]server_name
]
undelete
mps-service [-C [
displays the Windows service entry for the server instance.path
\]server_name
]
mps-service list
lists the Windows service entries for all server instances.
Input Arguments
|
Path to server instance |
|
Name of the server instance |
|
Display name for the Windows service associated with the server instance |
|
Informational statement describing the Windows service associated with the server instance |
|
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. |
|
Password for the service user account |
|
Updated path to server instance |
|
Indicate that no prompts are generated |
|
Force deletion without prompting |
|
Include details about why the service is not valid. |
Examples
Create Windows Service for Server Instance
To create a default Windows service for the server instance server_1
located in
a folder tmp
, type the following at the system command
line:
mps-service -C tmp\server_1 create
Delete Windows Service for Server Instance
To delete the Windows service entry for the server instance server_1
located in a folder tmp
, type the following at the system command
line:
mps-service -C tmp\server_1 delete
List Existing Windows Services
To list the Windows service entries for all the server instances installed on the local machine, type the following at the system command line:
mps-service list
Service Name: MATLAB Production Server {01234567-89ab-cdef-0123-456789abcdef} Display Name: MATLAB Production Server - My Custom Name Description: My Description Instance Root: C:\instances\instance1 MPS Root: C:\Program Files\MATLAB\MATLAB Production Server\R2014b Status: Started Service Name: MATLAB Production Server {01234567-89ab-cdef-0123-456789abcdef} Display Name: MATLAB Production Server - c:\instances\instance2 Description: MATLAB Production Server running instance C:\instances\instance2 Instance Root: C:\instances\instance2 MPS Root: C:\Program Files\MATLAB\MATLAB Production Server\R2015a Status: Stopped
Version History
Introduced in R2015a