startworker
Start MATLAB worker session
Syntax
startworker
startworker -flags
Description
startworker starts a MATLAB® worker process under the mjs service, which maintains it after that. The
worker registers with the specified job manager, from which it will get tasks for
evaluation. The mjs service must already be running on the specified computer.
The startworker executable resides in the folder
matlabroot\toolbox\parallel\bin
(Windows® operating system) or
matlabroot/toolbox/parallel/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 Specifies the name of the MATLAB worker. The default is the value of the
DEFAULT_WORKER_NAME parameter in the
mjs_def file.
-remotehost 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 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
mjs_def file.
-jobmanagerhost 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 mjs_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 Specifies the base port that the mjs service on the remote host is using. You
only need to specify this if the value of BASE_PORT in the
local mjs_def file does not match the base port being used by
the mjs 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