Sun Management Center 3.6 系统可靠性管理器用户指南

脚本启动程序模块

使用脚本启动程序模块,您可以将管理功能委托给代理。管理功能是用管理脚本编程语言编写的管理脚本。脚本启动程序模块是一个多实例模块,其所有实例均访问同一个脚本存储库模块,以获取语言和脚本信息。


注 –

(在 Solaris 10 上)您可以通过脚本启动程序模块运行 DScript。



注意 – 注意 –

某些 DScript 可能进行连续监视操作。这种脚本的输出将会很大。由于此类脚本会降低 CPU 的速度,还可能使 Java 控制台挂起,因此建议避免使用它们。


可以将以下代码片断添加到任何 DScrip 中,用以控制特定时间段内的执行流。

tick-1sec
/i++ >= 10/
{
exit(0);
}

在此例中,DScript 只执行 10 秒钟。用户可以在 10 秒钟后看到输出。

脚本启动程序模块包含以下两个表:

脚本启动程序模块的启动表和结果表

使用脚本启动程序模块,您可以对脚本进行以下操作:

脚本启动程序模块的安全性实现方式如下:

Procedure访问脚本启动程序模块

开始之前

必须首先加载脚本存储库模块,然后才能使用脚本启动程序模块。

步骤
  1. 加载模块。

    请参见《Sun Management Center 3.6 用户指南》,以获取更多信息。在“浏览器”窗口中的“本地应用程序”下可以找到脚本存储库模块。

  2. 在“浏览器”窗口中,双击“本地应用程序”。

  3. 双击“脚本启动程序”。

    脚本启动程序将显示启动表和结果表。

    显示脚本启动程序和表的模块浏览器。文中对该图形进行了说明。

启动表

启动表控制所有脚本的执行。它说明了准备启动的脚本及其参数。

启动表中的某一项向脚本添加了一个参数,还定义了脚本拥有者,即谁拥有执行该脚本的权限。

通过此表中的一个单独项可以创建多个脚本实例,此表中的多个项也可以指向脚本表中的同一个脚本。您可以用不同的参数和权限来执行多个相同的脚本。只有拥有启动拥有者权限的用户才能运行脚本。

启动表中的属性如下表所列。

表 5–2 启动表属性

特性 

说明 

启动拥有者 

拥有此项的管理者。 

启动名称 

项的名称,启动表中每行的名称都应该是唯一的。 

脚本拥有者 

与脚本名称一起标识脚本。 

脚本名称 

与脚本拥有者一起标识脚本。 

提供给脚本的参数。 

启动开始 

启动脚本的执行。在脚本启动之前,必须满足以下条件: 

  1. 该项的“操作状态”应该处于启用状态。

  2. 脚本表中应该有一项的值与“脚本拥有者”和“脚本名称”字段的值相同。

  3. 脚本表中的“脚本操作状态”字段应该处于启用状态。

  4. 启动拥有者具备启动脚本所需的安全权限。

启动控制 

此对象用于为从启动表启动的运行表中所有正在运行的脚本请求状态改变。 

管理状态 

此启动表项所需的状态,可以是启用或禁用。 

操作状态 

此启动表项的实际状态,可以是启用或禁用。 

最大运行数 

从此项调用的并发运行脚本的最大数目,默认值为 3。可以修改该字段的值。修改时直接在其中写入新值即可。 

最大完成数 

默认值为 3。表示从启动表中的这一项调用的脚本在完成后,允许保留在结果表中的最大数目。 

生存期 

从此项启动的脚本可以运行的最长缺省时间,缺省值是 86,400 秒(1 天)。 

到期时间 

有关从此项启动的脚本的信息在脚本执行完毕后保存在结果表中的最长缺省时间。 

Procedure向启动表添加新项

步骤
  1. 按照访问脚本启动程序模块中所述,访问启动表。

  2. 在启动表标题上按鼠标按钮 3。

    显示弹出菜单。

    带有启动表和菜单的模块浏览器。文中对该图形进行了说明。
  3. 选择“新行”并提供所有必需参数。

    “脚本拥有者”和“脚本名称”的值指向从此启动按钮启动的脚本。

Procedure启动脚本实例

步骤
  1. 按照访问脚本启动程序模块中所述,访问启动表。

  2. 在显示所需脚本名称的行上按鼠标按钮 3。

  3. 选择“启动脚本”。

    该脚本将启动。

Procedure停止脚本运行

步骤
  1. 按照访问脚本启动程序模块中所述,访问启动表。

  2. 在显示要停止的脚本的行上按鼠标按钮 3。

    将显示弹出式菜单。

  3. 选择“中断脚本”。

    脚本将停止运行。

结果表

结果表列出当前正在运行或最近终止运行的所有脚本。该表包含以下信息:

结果表中的每一行都包含脚本调用过程中传递的参数、脚本生成的结果以及脚本退出代码。结果表还提供了当前运行状态、开始时间戳和结束时间戳等信息。

结果表中显示的属性如下表所列。

表 5–3 结果表属性

属性 

说明 

运行索引 

与脚本关联的唯一标识符,其值由一个递增整数与 launchName 连接而成。其中,递增整数从 0 开始递增。 

参数 

启动脚本时提供给它的参数。 

退出代码 

脚本结束执行的原因。其值可以是: 

  • 无 – 脚本仍处于初始化或运行状态。

  • 停止 – 脚本已被中断。

  • 成功 – 脚本成功完成执行。

  • 失败 – 脚本由于出错而结束执行。

结果日志 

日志文件的路径。 

运行控制 

由此行定义的脚本执行的所需状态(中断或空指令)。 

运行状态 

脚本执行状态。其值可以是: 

  • 正在初始化 – 脚本正在初始化。

  • 正在运行 – 脚本正在运行。

  • 不在运行 – 脚本由于成功完成、失败或中断而处于这种状态,“退出代码”字段反映脚本处于“不在运行”状态的确切原因。

错误日志 

日志文件的路径。 

开始时间 

执行开始的日期和时间。 

结束时间 

执行终止的日期和时间。 

生存期 

脚本允许执行的时间长度。如果到此时间时脚本仍未终止,将会自动终止该脚本。 

到期时间 

脚本终止后,该行可以在结果表中存在的时间长度。此属性的值是脚本启动时启动表中“到期时间”字段的值。自脚本到达“不在运行”状态,并经过“到期时间”字段指定的时间秒数后,将从结果表中删除脚本项。 

Procedure从结果表查看结果

步骤
  1. 按照访问脚本存储库模块中所述,访问结果表。

  2. 在结果表中正在运行的脚本项上按鼠标按钮 3。

    显示弹出菜单。

  3. 选择“查看结果日志”查看选定脚本的相应结果日志文件。

    将显示“探测查看器”,其中显示日志结果。


    注 –

    您也可以通过命令行来访问日志文件。日志文件保存在 /var/opt/SUNWsymon /SysMgmtPack/script-launcher/scripts/UserName/logs 目录中。日志文件名称包含正在运行的实例,因此当用户多次运行同一个脚本时,当前日志文件是相同的。


Procedure从结果表中删除行

步骤
  1. 按照访问脚本存储库模块中所述,访问结果表。

  2. 在结果表中的行上按鼠标按钮 3。

    显示弹出菜单。

  3. 选择“删除行”。

    将显示一个对话框,供用户确认或取消删除。

  4. 单击 Yes(是)确认。

    删除行后,运行表将会立即自动刷新。