startworker

Start MATLAB worker session

Syntax

startworker
startworker -flags

Description

startworker starts a MATLAB® worker process under the mdce service, which maintains it after that. The worker registers with the specified job manager, from which it will get tasks for evaluation. The mdce service must already be running on the specified computer.

The startworker executable resides in the folder matlabroot\toolbox\distcomp\bin (Windows® operating system) or matlabroot/toolbox/distcomp/bin (UNIX® operating system). Enter the following command syntax at a DOS or UNIX command-line prompt, respectively.

startworker -flags accepts the following input flags. Multiple flags can be used together on the same command, except where noted.

FlagOperation
-name <worker_name>Specifies the name of the MATLAB worker. The default is the value of the DEFAULT_WORKER_NAME parameter in the mdce_def file.
-remotehost <hostname>Specifies the name of the computer where you want to start the MATLAB worker. If omitted, the worker is started on the local computer.
-jobmanager <job_manager_name>Specifies the name of the job manager this MATLAB worker will receive tasks from. The default is the value of the DEFAULT_JOB_MANAGER_NAME parameter in the mdce_def file.
-jobmanagerhost <job_manager_hostname>

Specifies the host on which the job manager is running. The worker contacts the job manager lookup process on that host to register with the job manager.

This overrides the setting of JOB_MANAGER_HOST in the mdce_def file on the worker computer. You must specify the job manager host by one of these means.

-cleanDeletes all checkpoint information associated with this worker name before starting.
-baseport <port_number>Specifies the base port that the mdce service on the remote host is using. You only need to specify this if the value of BASE_PORT in the local mdce_def file does not match the base port being used by the mdce service on the remote host.
-vVerbose mode displays the progress of the command execution.

Examples

Start a worker on the local host, using the default worker name, registering with the job manager MyJobManager on the host JMHost.

startworker -jobmanager MyJobManager -jobmanagerhost JMHost

Start a worker on the host WorkerHost, using the default worker name, and registering with the job manager MyJobManager on the host JMHost. (The following command should be entered on a single line.)

startworker -jobmanager MyJobManager -jobmanagerhost JMHost 
               -remotehost WorkerHost

Start two workers, named worker1 and worker2, on the host WorkerHost, registering with the job manager MyJobManager that is running on the host JMHost. Note that to start two workers on the same computer, you must give them different names. (Each of the two commands below should be entered on a single line.)

startworker -name worker1 -remotehost WorkerHost 
               -jobmanager MyJobManager -jobmanagerhost JMHost
startworker -name worker2 -remotehost WorkerHost 
               -jobmanager MyJobManager -jobmanagerhost JMHost 

Was this topic helpful?