命令行选项参考

以下命令行选项适用于Design Manager

某些命令可接受带有内嵌引号的参数。在 Linux 中使用 C 壳体时,将 set backslash_quote 添加到 ~/.cshrc 文件。此变量确保内嵌引号可正确转义。

Design Manager选项

starccm+ [project] 命令可启动Design Manager服务器并加载指定的Design Manager项目文件 (*.dmprj)。可以使用以下Design Manager服务器选项:

-dmnoshare
指定未经许可的设计管理器服务器许可方案
预分配模式下运行Design Manager时,不支持该选项。
-passtodesign <options>
指定要传递到设计模拟的模拟选项,例如,许可证选项或其他 Simcenter STAR-CCM+ 选项。请参见命令行参考
从命令行传递模拟选项对于机器特定选项或用户特定选项(例如,按需授权 (PoD) 许可证密钥)十分有用。
示例starccm+ [project] -dmnoshare -passtodesign "-power -podkey <value> -licpath 1999@flex.cd-adapco.com"
或者,可以从 GUI 传递命令行选项。请参见 STAR-CCM+ 命令行。从 GUI 传递命令行选项对于要保存在Design Manager项目中的常规模拟命令行选项十分有用。
由于Design Manager控制设计模拟的资源管理,因此不能将资源管理选项传递到设计模拟。因此,不支持以下资源指定选项:
  • -batchsystem
  • -bs
  • -hostregexpr
  • -machinefile
  • -np
  • -on
-passtodesign <options> 选项不支持需要双引号的参数,例如,-mpidriver intel:"-genv VARIABLE value"。必须从 GUI 传递这些选项。
-preallocpower
指定仅当在预分配模式下运行时才使用无限制并行许可证。
-dmnoshare 类似,指定的选项指示Design Manager服务器不提取任何许可证。
此外,它将 -power 隐式传递到设计模拟。不需要选项 -passtodesign "-power"
示例starlaunch jobmanager --command "starccm+ [project] -preallocpower"
-doepower
使用默认许可方案时,指定提取无限制并行许可证 (ccmppower)(而不是 ccmpsuite 许可证)作为会话许可证。将此选项与 -podkey <value> 结合使用,可使用按需授权 (PoD) 许可证。
预分配模式下运行Design Manager并使用 -doepower 选项时,还必须将此选项传递到Design Manager服务器。
示例starlaunch jobmanager --command "starccm+ [project] -doepower -passtodesign \"-doepower\""
-notokens
指定不将 doetoken 许可证用于设计模拟。
预分配模式下运行Design Manager并将 -notokens 选项传递到设计模拟时,还必须将此选项传递到Design Manager服务器。
示例starlaunch jobmanager --command "starccm+ [project] -notokens -passtodesign \"-notokens\""

资源管理器选项

预分配模式下运行Design Manager时,资源管理器将提供实际资源管理功能。以下命令行选项可用于 starlaunch

--command <batch_command>
指定以批处理模式运行Design Manager项目的命令。
--scratch_root <path>
调用本地暂存空间的使用,并指定本地磁盘上临时根目录的路径。必须拥有此目录的写权限,并且所有群集节点上的目录路径必须相同。有关更多信息,请参见在具有本地暂存空间的 Linux 群集上运行
--cwd <路径>
指定工作目录的路径。在具有本地暂存空间的群集上运行Design Manager时,此工作目录必须位于 .scratch_root <path> 命令行选项中指定的临时根目录下。

未设置此选项时,Design Manager默认为 starlaunch 进程的当前工作目录。

--slots 0
指定不为 jobmanager 进程分配任何处理器。
--batchsystem <system>
指定集群上的批处理管理系统。
--resources <host[:np][,host[:np]]>
指定允许Design Manager在其上运行设计模拟的一组网格机器。
--resourcefile <file>
指定列出允许Design Manager在其上运行设计模拟的机器的 MPI 文件。

示例starlaunch jobmanager --command "[STARCCM+_INSTALL_DIR]/star/bin/starccm+ -rsh ssh -batch run -preallocpower [project]" --slots 0 --batchsystem pbs

许可证选项

Design Manager中运行设计研究时,以下选项可控制许可证使用情况:

-doepower
使用默认许可方案时,使用无限制并行许可证 (ccmppower)(而不是 ccmpsuite 许可证)作为会话许可证。将此选项与 -podkey <value> 结合使用,可使用按需授权 (PoD) 许可证。
-licpath <path:...>
指定覆盖默认许可证路径的许可证路径。当使用此选项时,Simcenter STAR-CCM+ 使用该路径为生成的服务器会话定义新的 CDLMD_LICENSE_FILE 环境变量。
示例-licpath 1999@flex.cd-adapco.com(按需授权 (PoD) 许可证服务器)
-nosuite
阻止 ccmpsuite 许可证用于启用内核进行并行计算。只有并行许可证(例如,PoD 令牌)才用于启用内核进行并行计算。
-notokens
指定不将 doetoken 许可证用于设计模拟。
-podkey <value>
指定 PoD 许可证密钥。
-power
指定为每个设计模拟分配无限制并行许可证。将此选项与 -podkey <value> 结合使用,可启用按需授权 (PoD) 许可。
预分配模式下运行Design Manager时,不支持该选项。要在预分配模式下分配无限制并行许可证,使用Design Manager选项 -preallocpower
-tokensonly
指定仅将 doetoken 许可证用于设计模拟。通过此选项,还可以使用 doetoken 许可证来启动 Simcenter STAR-CCM+ 的常规并行计算。

对于默认许可方案,下表显示了支持的许可证选项组合以及关联的许可证使用情况:

命令行选项

会话许可证

内核许可证

并行许可证

无。 ccmpsuite DOEtoken/ccmpsuite DOEtoken/ccmpsuite
-tokensonly ccmpsuite DOEtoken DOEtoken
-notokens ccmpsuite ccmpsuite ccmpsuite
-notokens -power ccmpsuite ccmppower 不适用
-nosuite ccmpsuite DOEtoken/ccmpsuite DOEtoken
-power ccmpsuite DOEtoken/ccmppower DOEtoken/ccmpsuite
-power -nosuite ccmpsuite DOEtoken/ccmppower DOEtoken
-doepower ccmppower DOEtoken/ccmpsuite DOEtoken/ccmpsuite
-doepower -tokensonly ccmppower DOEtoken DOEtoken
-doepower -notokens ccmppower ccmpsuite ccmpsuite
-doepower -notokens -power ccmppower ccmppower 不适用
-doepower -nosuite ccmppower DOEtoken/ccmpsuite DOEtoken
-doepower -power ccmppower DOEtoken/ccmppower DOEtoken/ccmpsuite
-doepower -power -nosuite ccmppower DOEtoken/ccmppower DOEtoken

其中,DOEtoken/ccmpsuiteDOEtoken/ccmppower 表示:

  1. Design Manager尝试使用 DOEtoken 满足许可证要求。
  2. 如果没有足够的许可证,Design Manager将尝试分别使用 ccmpsuiteccmppower 满足其余要求。
对于未经许可的设计管理器服务器许可方案,命令行选项和相应的许可规则遵循独立 STAR-CCM+ 许可