Start MATLAB worker session
startworker
startworker -flags
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
(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.matlabroot
/toolbox/distcomp/bin
startworker
accepts the following
input flags. Multiple flags can be used together on the same command, except where
noted.-flags
Flag | Operation |
---|---|
-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 |
-clean | Deletes 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. |
-v | Verbose mode displays the progress of the command execution. |
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
mdce
| nodestatus
| startjobmanager
| stopjobmanager
| stopworker