自定义示例插件脚本的行为

使用通用调度器接口时，您可以通过使用 AdditionalProperties 设置通用集群配置文件或对象的附加属性来修改插件脚本的行为。有关通用调度器接口的更多信息，请参阅使用通用调度器接口进行配置。

其他属性

示例插件脚本允许您设置这些属性。

所有调度程序的属性

属性	描述	数据类型
`AdditionalSubmitArgs`	用于作业提交的附加调度器参数。示例插件脚本将此属性的值添加到调度器提交字符串。	`String`
`AuthenticationMode`	用于指示您连接到集群时如何进行身份验证的选项，指定为以下之一： `"Agent"` - 客户端与在客户端计算机上运行的 SSH 代理进行交互。 `"IdentityFile"` ——客户端使用 `IdentityFile` 附加属性指定的身份文件。 `"Multifactor"` ——客户端会提示您输入一次或多次。例如，如果客户端上启用了双因素身份验证 (2FA)，则客户端会请求您的密码和第二个身份验证因素的响应。 `"Password"` - 客户端提示您输入 SSH 密码。您的用户名由 `Username` 附加属性指定。	`String` `String array`
`ClusterHost`	具有用于提交作业的调度器程序实用程序的集群机器的主机名。如果您的集群无法直接向调度器提交作业，请使用此功能。集群机器必须运行 Linux。	`String`
`DisplaySubmitArgs`	用于显示提交作业时传递给调度器的作业提交标志和选项的选项。标志和选项显示在命令行上。	`Logical`
`IdentityFile`	在集群主机上识别您的 SSH 身份文件的客户端计算机机器的位置。	`String` `String array`
`IdentityFileHasPassphrase`	选择使用密码作为身份文件。如果 `IdentityFile` 需要密码，则将此属性设置为 `true`。	`Logical`
`RemoteJobStorageLocation`	在集群上存储作业文件的位置。如果您的客户端和集群节点没有共享文件系统，请使用此属性。	`String`
`SSHPort`	SSH 连接的集群主机端口号。使用此属性设置通过 SSH 连接的集群主机上的端口。	`Double`
`UseIdentityFile`	使用身份文件的选项。如果您想使用 SSH 身份文件登录到集群主机，请将此属性设置为 `true`。如果设置此属性，则也设置 `IdentityFile` 和 `IdentityFileHasPassphrase`。	`Logical`
`Username`	登录集群主机的用户名。	`String`
`UseUniqueSubfolders`	选择使用唯一子文件夹。如果您希望 MATLAB^® 根据用户名和 MATLAB 版本将作业文件存储在不同的子文件夹下，请将此属性设置为 `true`这样做有助于防止不同用户和 MATLAB 版本提交的作业之间发生冲突。	`Logical`

每个调度器的特定属性

仅适用于 Slurm 的属性

属性	描述	数据类型
`AccountName`	调度器对所使用的资源收费的账户名称。	`String`
`Constraint`	运行作业所需的节点特性。	`String`
`MemPerCPU`	每个 CPU 所需的最小内存。	`String`
`Partition`	对作业资源分配进行分区。	`String`
`RequireExclusiveNode`	与其他正在运行的作业共享节点的选项。如果该作业不能与其他正在运行的作业共享节点，则将此属性设置为 `true`。	`Logical`
`Reservation`	调度器可以根据此预留名称为该作业分配资源。	`String`
`WallTime`	限制该作业的总运行时间。	`String`
`EmailAddress`	接收来自调度器通知的电子邮件地址。	`String`

仅适用于 LSF 的属性

属性	描述	数据类型
`MemPerCPU`	每个 CPU 所需的最小内存。	`String`
`Project`	调度器分配该作业的项目。	`String`
`QueueName`	调度器在其上运行作业的集群队列名称。	`String`
`RequireExclusiveNode`	与其他正在运行的作业共享节点的选项。如果该作业不能与其他正在运行的作业共享节点，则将此属性设置为 `true`。	`Logical`
`WallTime`	限制该作业的总运行时间。	`String`
`EmailAddress`	接收来自调度器通知的电子邮件地址。	`String`

仅适用于 Grid Engine 系列的属性

属性	描述	数据类型
`AccountName`	调度器运行作业的账户名。	`String`
`MemPerCPU`	每个 CPU 所需的最小内存。	`String`
`Project`	调度器分配该作业的项目。	`String`
`QueueName`	运行该作业的集群队列名称。	`String`
`WallTime`	限制该作业的总运行时间。	`String`
`EmailAddress`	接收来自调度器通知的电子邮件地址。	`String`

仅适用于 PBS 的属性

属性	描述	数据类型
`AccountName`	调度器对所使用的资源收费的账户名称。	`String`
`Priority`	该作业相对于集群中其他作业的优先级。	`Double`
`ProcsPerNode`	每个节点的处理器数量，指定为有限正整数标量。当您向集群提交作业时，MATLAB 请求的每个节点的核心数保证小于或等于 `ProcsPerNode`。将 `ProcsPerNode` 设置为您希望 MATLAB 从每个集群节点请求的最大处理器数量。 MATLAB 请求运行作业所需的每个节点的最小核心数。如果集群的 `NumThreads` 属性小于或等于 `ProcsPerNode`，MATLAB 将为每个工作进程请求 `NumThreads` 个处理器，然后最大化每个节点的工作进程数量。例如，如果 `ProcsPerNode` 为 `16` 且 `NumThreads` 为 `5`，则 MATLAB 请求 `15` 核心，即小于 `ProcsPerNode` 的 `5` 的最大倍数。如果集群的 `NumThreads` 大于 `ProcsPerNode`，则 MATLAB 会向每个节点请求 `ProcsPerNode` 处理器。当 `NumThreads` 大于 `ProcsPerNode` 时，您可能会遇到性能问题。作为最佳实践，请将 `NumThreads` 设置为小于或等于 `ProcsPerNode`。有关详细信息，请参阅编辑工作进程数量和集群设置 (Parallel Computing Toolbox)。	`Positive integer scalar`
`QueueName`	运行该作业的集群队列或服务器名称。	`String`
`WallTime`	限制该作业的总运行时间。	`String`
`EmailAddress`	接收来自调度器通知的电子邮件地址。	`String`

仅适用于 HTCondor 的属性

属性	描述	数据类型
`AccountingGroup`	调度器作业所依据的会计组名称。	`String`
`AccountingGroupUsername`	资源使用核算的用户名。	`String`
`RequestDisk`	该作业对磁盘空间的要求。	`String`
`RequestMemory`	该作业对内存的要求。	`String`
`Priority`	该作业相对于集群中其他作业的优先级。	`Double`
`Requirements`	运行作业所需的节点特性。	`String`
`EmailAddress`	接收来自调度器通知的电子邮件地址。	`String`

仅适用于 AWS Batch 的属性

属性	描述	数据类型
`IndependentJobDefinition`	独立 MATLAB 作业的 AWS^® Batch 作业定义。	`String`
`JobQueue`	集群的 AWS Batch 作业队列	`String`
`LicenseServer`	运行网络许可证管理器的机器的端口号和主机名。以 `port@hostname` 格式指定此属性。	`String`
`S3Bucket`	用于客户端和 MATLAB 工作进程之间传输数据 Amazon S3™ 存储桶	`String`

设置其他属性

您可以使用集群配置文件管理器或以编程方式在集群配置文件中设置其他属性。

在群集配置文件中设置属性

当您在集群配置文件中设置附加属性时，每次使用集群时都会应用这些属性。

在 MATLAB 工具条的主页选项卡上的环境区域中，选择并行 > 创建和管理集群。
在集群配置文件管理器中，点击要修改的通用配置文件。
点击右下角的编辑。
转到 AdditionalProperties 表。
要添加新属性，请点击添加。要修改现有属性，请点击该属性。

下图显示了为 LSF^® 集群配置文件设置 AdditionalSubmitArgs 的示例。

Cluster Profile Manager with the LSF profile selected. The properties for the cluster are shown in the right panel. The Additional Properties entry is being edited.

通过编程设置属性

您可以通过访问通用集群对象的 AdditionalProperties 以编程方式设置附加属性。请注意，此操作不会更新集群配置文件，并且属性仅适用于该特定集群对象。以下是如何为 LSF 集群设置 AdditionalSubmitArgs 的示例。

首先，使用 parcluster 函数创建一个集群对象。在以下代码中，将 MyLSFCluster 更改为您的集群配置文件的名称。

c = parcluster("MyLSFCluster");

接下来，设置 AdditionalSubmitArgs，以便插件脚本使用不同的作业队列。

c.AdditionalProperties.AdditionalSubmitArgs = '-q matlab_queue';

通过此更改，当您提交作业时，MATLAB 会将附加参数传递给调度器。例如提交批处理作业。

job = batch(c,"myScript");

有关使用 AdditionalProperties 在运行时修改插件脚本功能的其他示例，请参阅添加用户自定义 (Parallel Computing Toolbox)。