Main Content

startworker

启动 MATLAB 工作进程会话

语法

startworker
startworker -flags

描述

startworker 在 mjs 服务下启动一个 MATLAB® 工作进程,之后由该进程负责维护该进程。工作进程向指定的作业管理器进行注册,并从中获取需要评估的任务。mjs 服务必须已在指定的计算机上运行。

startworker 可执行文件位于文件夹 matlabroot\toolbox\parallel\bin (Windows® 操作系统)或 matlabroot/toolbox/parallel/bin (UNIX® 操作系统)中。分别在 Windows 或 UNIX 命令行提示符下输入以下命令语法。

startworker -flags 接受以下输入标志。除非另有说明,可以在同一个命令上一起使用多个标志。

标志运算
-name <worker_name>

指定 MATLAB 工作进程的名称。默认值是 mjs_def 文件中 DEFAULT_WORKER_NAME 参数的值。

-remotehost <hostname>

指定要启动 MATLAB 工作进程的计算机的名称。如果省略,则工作进程将在本地计算机上启动。

-jobmanager <job_manager_name>

指定此 MATLAB 工作进程将从中接收任务的作业管理器的名称。默认值是 mjs_def 文件中 DEFAULT_JOB_MANAGER_NAME 参数的值。

-jobmanagerhost <job_manager_hostname>

指定运行作业管理器的主机。工作进程联系该主机上的作业管理器查找进程来向作业管理器进行注册。

这将覆盖工作进程计算机上的 mjs_def 文件中 JOB_MANAGER_HOST 的设置。您必须通过以下方法之一指定作业管理器主机。

-clean

启动前删除与该工作进程名称关联的所有检查点信息。

-num <num_workers>

指定要启动的工作进程数量。默认值为 1。如果启动多个工作进程,工作进程名称后面会附加 '_1','_2',以此类推。

-baseport <port_number>

指定远程主机上的 mjs 服务正在使用的基准端口。仅当本地 mjs_def 文件中 BASE_PORT 的值与远程主机上 mjs 服务使用的基准端口不匹配时,您才需要指定此项。

-secretfile <path_to_shared_secret_file>

指定用于验证命令的共享密钥文件的路径。使用此标志来覆盖本地 mjs_def 文件中 SHARED_SECRET_FILE 的值。如果未指定,命令将尝试使用本地 mjs_def 文件中的路径或默认位置:

$CHECKPOINTBASE/security/secret

-v

详细模式显示命令执行的进度。

示例

在本地主机上启动一个工作进程,使用默认的工作进程名称,并在主机 JMHost 上的作业管理器 MyJobManager 上注册。

startworker -jobmanager MyJobManager -jobmanagerhost JMHost

在主机 WorkerHost 上启动一个工作进程,使用默认的工作进程名称,并在主机 JMHost 上向作业管理器 MyJobManager 注册。(以下命令应在一行上输入。)

startworker -jobmanager MyJobManager -jobmanagerhost JMHost 
               -remotehost WorkerHost

在主机 WorkerHost 上启动两个工作进程,分别名为 worker_1worker_2,并向运行在主机 JMHost 上的作业管理器 MyJobManager 进行注册。(以下命令应在一行上输入。)

startworker -num 2 -name worker -remotehost WorkerHost 
               -jobmanager MyJobManager -jobmanagerhost JMHost