从命令行或脚本渲染作业

使用 Backburner 命令行插件,将批处理文件、可执行文件或脚本文件提交给 Backburner 作为“自定义”作业。例如,您可以创建一个脚本,它提交网络文件夹中包含的所有作业,以在晚上自动进行渲染。

要使用命令行插件渲染作业,请使用 Backburner 文件夹中的 Windows cmdjob.exe 工具。该工具提供了从脚本运行自定义作业的灵活性。

警告:对 cmdjob 工具的安全性应给予特别关注,因为它可以在网络的所有渲染节点上远程执行命令。受过培训的系统管理员应该确保正确设置和管理执行权限。

Backburner 命令行控制

您可以在 DOS shell 或 Linux 终端的命令行以及批处理文件或脚本中使用以下开关。请注意有关这些开关的以下事项:

  • 开关不区分大小写。

  • 如果多次使用同一开关,则只有最后一次使用由 cmdjob 工具处理。

下表显示开关及其效果。

变量 定义的变量
-jobName [name] 设置作业名称,默认名称为“cmdJob”。
-jobNameAdjust 如果作业名称不唯一,则在其末尾附加一个数字。
-manager [name] 设置管理器的名称,默认名称是 automatic search。
-netmask [mask] 设置掩码。
-port [number] 设置端口号。
-priority [number] 设置作业优先级:临界值为 0,默认值为 50,挂起值为 100。
-suspended 将作业提交为挂起。
-progress 显示在作业被处理时,shell 中作业的进度。
-emailFrom [address] 设置通知电子邮件的源电子邮件地址。
-emailTo [address] 设置通知电子邮件的目标电子邮件地址。
-emailServer [server] 设置发送通知电子邮件使用的 SMTP 电子邮件服务器 Backburner 的名称。
-emailCompletion 完成作业后,发送通知电子邮件。
-emailFailure 如果作业失败,发送通知电子邮件。
-emailProgress [number] 当完成您设置的多个任务时,发送通知电子邮件。
-workPath [folder] cmdjob 工具的工作文件夹或目录。默认值为“…\backburner\Network\ServerJob”文件夹。在 cmdjob 工具解释处理作业的选项之前设置该路径。此路径还被设置为服务器的工作路径。如果未设置工作文件夹,则在提交作业时,必须指定可执行文件和目标文件的完整路径名称。
-logPath [folder] 指定在其中创建“每个任务”日志的文件夹或目录的位置。因为如果文件夹不存在,则命令行工具无法创建此文件夹,所以此位置必须指定一个现有的文件夹。默认情况下禁用此选项。
-description [string] 设置作业描述。
-showOutput [file;file;...] 设置可从 Backburner 监视器或 Web 监视器访问的输出文件列表。
-group [string] 定义向其提交该作业的服务器组。
-servers [string;string…] 定义向其提交该作业的服务器组。如果服务器组使用“组”进行了指定,则忽略它。
-serverCount [number] 设置可以同时处理作业的服务器的最大数量。
-attach 将批处理文件作为 .zip 文件附加到作业。然后,处理作业之前在每台计算机上解压缩批处理文件。
-taskList [file] 设置任务列表文件。
-numTasks [number] 设置作业的任务数。
-tp_start [number] 设置默认的任务参数的始端偏移(采用数值格式)。如果指定 -taskList,则忽略。
-tp_jump [number] 设置默认的任务参数的增量(采用数值格式)。如果使用 -taskList,则忽略。
-jobParamFile [file] 设置作业参数文件。请参见下面的示例。
-taskName [number] 在任务列表文件中设置任务名称列。值为 0 表示此列未命名,而大于 0 的值指定了文件中任务名称的列。此选项用于查看任务列表时监视器上的反馈。
-perServer 创建与此作业相同的单独作业,并为已指定给此作业的每台服务器指定一个作业。每台服务器将与其他服务器执行相同任务。
-timeout [number] 出现任务超时前的分钟数。默认值为 60 分钟。
-nonConcurrent 禁止在多台计算机上执行多个任务。
-leaveInQueue 完成后将作业留在队列中。除非进行了设置,否则 Backburner 管理器的默认行为用于存档作业或删除作业。
-archive 完成时,使用 Backburner 管理器的默认行为存档作业。如果使用 –leaveInQueue 则忽略。
-archive [days] 完成后在指定天数后存档作业。如果使用 –leaveInQueue 则忽略。
-dependencies [string;string…] 定义作业从属关系的列表。
-delete 完成时,使用 Backburner 管理器的默认行为删除作业。如果使用 –leaveInQueue 或 -archive 则忽略。
-delete [days] 完成后在指定天数后删除作业。默认设置是执行管理器操作。如果使用 –leaveInQueue 或 -archive 则忽略。
-dontBlockTasks 禁用任务阻塞,默认情况下,在 Backburner 管理器中启用任务阻塞。
-blockTasks 启用任务阻塞,默认情况下,在 Backburner 管理器中启用任务阻塞。

CGplusplus.com