Main Content

Access Service Record Files

The MATLAB® Parallel Server™ services generate various record files in the normal course of their operations. The mjs service, job manager, and worker sessions all generate such files. This section describes the types of information stored by the services.

Locate Log Files

Log files for each service contain entries for the service’s operations. These might be of particular interest to the network administrator in cases when problems arise.

Operating System

File Location

Windows®

The default location of the log files is <PROGRAMDATA>\MJS\Log, where <PROGRAMDATA> is the value of the system PROGRAMDATA variable. For example, if PROGRAMDATA is set to C:\ProgramData, the log files are placed in C:\ProgramData\MJS\Log.

You can set alternative locations for the log files by modifying the LOGBASE setting in the mjs_def.bat file before starting the mjs service.

Linux®

The default location of the log files is /var/log/mjs/.

You can set alternative locations for the log files by modifying the LOGBASE setting in the mjs_def.sh file before starting the mjs service.

Locate Checkpoint Folders

Checkpoint folders contain information related to persistence data, which the server services use to create continuity from one instance of a session to another. For example, if you stop and restart a job manager, the new session continues the old session, using all the same data.

A primary feature offered by the checkpoint folders is in crash recovery. This allows server services to automatically resume their sessions after a system goes down and comes back up, minimizing the loss of data. However, if a MATLAB worker goes down during the evaluation of a task, that task is neither reevaluated nor reassigned to another worker. In this case, a finished job may not have a complete set of output data, because data from any unfinished tasks might be missing.

Note

If a job manager crashes and restarts, its workers can take up to 2 minutes to reregister with it.

Platform

File Location

Windows

The default location of the checkpoint folders is <PROGRAMDATA>\MJS\Checkpoint, where <PROGRAMDATA> is the value of the system PROGRAMDATA variable. For example, if PROGRAMDATA is set to C:\ProgramData, the checkpoint folders are placed in C:\ProgramData\MJS\Checkpoint.

You can set alternative locations for the checkpoint folders by modifying the CHECKPOINTBASE setting in the mjs_def.bat file before starting the mjs service.

Linux

The checkpoint folders are placed by default in /var/lib/mjs/.

You can set alternative locations for the checkpoint folder by modifying the CHECKPOINTBASE setting in the mjs_def.sh file before starting the mjs service.