MATLAB^® Distributed Computing Server™

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.

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

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 <jmhostname>`	Specifies the host on which the job manager is running by using `-jobmanagerhost`. The worker will then use unicast to contact the job manager lookup process on that host in order to register with the job manager. This overrides the setting of `JOB_MANAGER_HOST` in the `mdce_def` file on the worker computer, which would also have the worker use unicast. Cannot be used together with `-multicast`.
`-multicast`	If you are certain that multicast works on your network, you can force the worker to use multicast to locate the job manager lookup process by specifying `-multicast`. Note: If you are using this flag to change the settings of and restart a stopped worker, then you should also use the `-clean` flag. Cannot be used together with `-jobmanagerhost`.
`-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.

Examples

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

startworker -jobmanagername 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 -jobmanagername 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 
            -jobmanagername MyJobManager -jobmanagerhost JMHost
startworker -name worker2 -remotehost WorkerHost 
            -jobmanagername MyJobManager -jobmanagerhost JMHost

startworker - Start MATLAB® worker session

Syntax

Description

Examples

See Also

startworker - Start MATLAB^® worker session