Accessing Service Record Files :: Network Administration (MATLAB® Distributed Computing Server™)

MATLAB^® Distributed Computing Server™

Accessing Service Record Files

On this page…
Locating Log Files Locating Checkpoint Directories

On this page…

The MATLAB^® Distributed Computing Server™ services generate various record files in the normal course of their operations. The mdce service, job manager, and worker sessions all generate such files. The types of information stored by the services are described in this section.

Locating 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 `<TEMP>\MDCE\Log`, where `<TEMP>` is the value of the system `TEMP` variable. For example, if `TEMP` is set to `C:\TEMP`, then the log files are placed in `C:\TEMP\MDCE\Log`. You can set alternative locations for the log files by modifying the `LOGBASE` setting in the `mdce_def.bat` file before starting the mdce service.
UNIX^® and Macintosh^®	The default location of the log files is `/var/log/mdce/`. You can set alternative locations for the log files by modifying the `LOGBASE` setting in the `mdce_def.sh` file before starting the mdce service.

Operating System

File Location

Windows^®

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

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

UNIX^® and Macintosh^®

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

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

Locating Checkpoint Directories

Checkpoint directories 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 will continue the old session, using all the same data.

A primary feature offered by the checkpoint directories 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, as 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 directories is <TEMP>\MDCE\Checkpoint, where <TEMP> is the value of the system TEMP variable. For example, if TEMP is set to C:\TEMP, then the checkpoint directories are placed in C:\TEMP\MDCE\Checkpoint.
You can set alternative locations for the checkpoint directories by modifying the CHECKPOINTBASE setting in the mdce_def.bat file before starting the mdce service.

UNIX and Macintosh
The checkpoint directories are placed by default in /var/lib/mdce/.
You can set alternative locations for the checkpoint directories by modifying the CHECKPOINTBASE setting in the mdce_def.sh file before starting the mdce service.

Platform	File Location
Windows	The default location of the checkpoint directories is `<TEMP>\MDCE\Checkpoint`, where `<TEMP>` is the value of the system `TEMP` variable. For example, if `TEMP` is set to `C:\TEMP`, then the checkpoint directories are placed in `C:\TEMP\MDCE\Checkpoint`. You can set alternative locations for the checkpoint directories by modifying the `CHECKPOINTBASE` setting in the `mdce_def.bat` file before starting the mdce service.
UNIX and Macintosh	The checkpoint directories are placed by default in `/var/lib/mdce/`. You can set alternative locations for the checkpoint directories by modifying the `CHECKPOINTBASE` setting in the `mdce_def.sh` file before starting the mdce service.

Customizing Server Services

Troubleshooting