Main Content

Troubleshooting

Diagnose and fix problems with a server instance

Issues with MATLAB® Production Server™ instances can manifest as connectivity failures, slow downs, or server instance crashes. Use log information generated by a server instance to diagnose and solve problems.

Properties

endpoint-rootFolder used to store server named endpoints
hide-matlab-error-stackHide MATLAB error stack from clients
log-archive-max-sizeMaximum size of the log archive folder
log-archive-rootPath to the folder containing archived log files
log-rootPath to the folder containing log files
log-rotation-sizeSize at which the log is archived
log-severitySeverity at which messages are logged
log-handlerAdd custom log handler
main-log-formatText format for the main log file
pid-rootFolder used to store PID files
profileLog server profile information

Command-Line Scripts for Windows, Linux, and macOS

mps-checkTest and diagnose server instance for problems from command line on Windows, Linux, and macOS systems
mps-profileLog profile information for server instance from command line on Windows, Linux, and macOS systems
mps-statusDisplay status of server instance from command line on Windows, Linux, and macOS systems
mps-support-infoDisplay licensing and configuration information of server instance from command line on Windows, Linux, and macOS systems
mps-whichDisplay path to server instance that is currently using configured port from command line on Windows, Linux, and macOS systems

Topics

Verify Server Status

Use mps-status to check if the server is running.

Manage Log Files

Set properties in the main_config server configuration file to set log verbosity, and to rotate and archive logs.

Diagnose a Server Instance

Tips to diagnose a problem with a server.

Diagnose a Corrupted MATLAB Runtime

This example shows a typical diagnostic procedure you might follow to solve a problem starting server prod_server_x.

Server Diagnostic Tools

Each server writes a log file containing data from both the main server process, as well as the workers, named server_name/log/main.log.

Common Error Messages and Resolutions

List of common errors and possible resolutions.