“配置”屏幕

在 Agent Builder 完成创建资源类型的操作后，在“创建”屏幕上选择“下一步”，将会出现“配置”屏幕（如下图所示）。必须先创建资源类型才能存取“配置”屏幕。

图 9–3 “配置”屏幕

“配置”屏幕上包含以下字段：

• “启动命令”。可以传递到任意 UNIX shell 以启动基本应用程序的完整命令行。必须指定启动命令。您可以在提供的字段中键入该命令，或使用“浏览”按钮定位包含用来启动应用程序的命令的文件。

  完整的命令行必须包含启动应用程序必需的所有内容，例如主机名、端口号和指向配置文件的路径等。您也可以指定在特性变量中介绍的特性变量。如果基于 Korn shell 的应用程序要求您在命令行上指定主机名，则可以使用 Agent Builder 定义的 $hostnames 变量。请参见使用 Agent Builder 提供的 适用于 Korn Shell 的 $hostnames 变量。

  请不要将命令置于双引号 (””) 之间。

  ---

  注意 –

  如果基本应用程序具有多个独立的进程树（每一个进程树都在进程监视工具 (PMF) 控制下以其各自的标记来启动），则不能只指定一个命令。而是必须创建一个文本文件，其中包含启动每一个进程树的各个命令，并且还要在“启动命令”文本字段中指定指向此文件的路径。请参见创建具有多个独立的进程树的资源类型，其中列出了此文件正常工作所需的一些特殊特性。

  ---

• “停止命令”。可以传递到任意 UNIX shell 以停止基本应用程序的完整命令行。您可以在提供的字段中键入该命令，也可以使用“浏览”按钮定位包含用来停止应用程序的命令的文件。您也可以指定特性变量中介绍的特性变量。如果基于 Korn shell 的应用程序要求您在命令行上指定主机名，则可以使用 Agent Builder 定义的 $hostnames 变量。请参见使用 Agent Builder 提供的 适用于 Korn Shell 的 $hostnames 变量。

  此命令是可选的。如果不指定停止命令，则生成的代码将按以下步骤使用信号（包含在 Stop 方法中）来停止应用程序：

  • Stop 方法发送 SIGTERM 来停止应用程序，并等待应用程序退出（等待的时间为超时值的 80%）。

  • 如果 SIGTERM 信号没有成功停止应用程序，则 Stop 方法将发送 SIGKILL 来停止应用程序，并等待应用程序退出（等待的时间为超时值的 15%）。

  • 如果 SIGKILL 没有成功停止应用程序，Stop 方法将失败而退出。余下的 5% 的超时值被认为是系统开销。

  ---

  注意 –

  请确保该停止命令在应用程序完全停止之后返回。

  ---

• “探测命令”。此命令可以定期运行以检查应用程序的运行状况并返回相应的退出状态（介于 0 [成功] 和 100 [完全失败] 之间）。此命令是可选的。您可以键入指向该命令的完整路径，也可以使用“浏览”按钮来定位包含用来探测应用程序的命令的文件。

  通常，您需指定基本应用程序的简单客户机。如果您不指定探测命令，则生成的代码仅连接到资源所用的端口（或仅从该端口上断开连接）。如果探测成功，则表明该应用程序运行正常。您也可以指定特性变量中介绍的特性变量。如果基于 Korn shell 的应用程序要求您在命令行上的探测命令中指定主机名，则可以使用 Agent Builder 定义的 $hostnames 变量。请参见使用 Agent Builder 提供的 适用于 Korn Shell 的 $hostnames 变量。

• “超时”。每个命令的超时值（单位为秒）。您可以指定新值，或接受 Agent Builder 提供的缺省值（启动和停止的缺省值为 300 秒，探测的缺省值为 30 秒）。