Users Guide

CLI 故障信息可提供某些命令故障的原因。命令故障的常见原因包括语法错误和组件不存在。许多错误信息均提供了可用于成功执行命令的语法信息。
如果您尝试为系统配置中不存在的组件或功能执行命令，错误信息就会表明该组件不存在。
命令：
omconfig chassis volts index=3 minwarnthresh=3.3000
实例信息：
Error!（错误！） Number with up to 3 digits after decimal point expected, read 3.3000（小数点后的位数超过 3 位，读数为 3.3000 ）
The value given by the command specifies more than 3 digits after the decimal point. （此命令所指定的值在其小数点后超过 3 位数。） A valid
minimum warning threshold value for volts contains up to 3 digits after the decimal point.（有效的电压最小警告阈值在其小数点后最多保留 3 位。）
键入：
omconfig chassis volts index=3 minwarnthresh=3.300
当输入经过修改后保留 3 位小数点的命令时，会得到另一个错误信息：
Error!（错误！） This voltage probe min warning threshold must be between 11.400 and 12.480.（电压探测器最小警告阈值必须在 11.400 和 12.480 之
间。）
修改后的命令：
omconfig chassis volts index=3 minwarnthresh=11.500
信息：
Voltage probe warning threshold(s) set successfully.（电压探测器警告阈值已成功设置。）
使用 CLI 编写脚本和进行比较
Server Administrator CLI 使管理员可以编写要由操作系统执行的批处理程序或脚本。对于拥有许多系统的企业，管理员可以编写配置脚本，为系统的每个主要组件指定警告阈值，同时指
定出现警告或故障事件时希望各系统执行的一组操作。在最严重的情况下，管理员可以编写使系统关闭的脚本，以避免损坏系统。然后，管理员便可以同时在多个 Managed System 上分
发并执行该脚本。这样的方案可使您轻松地配置公司所需的任意数量的新系统，并更加容易地在许多需要重新配置的现有系统中实现新的系统管理策略。
您还可以采用类似方案将详细的资产信息批量载入大量新购置的系统。其中的许多信息均会相同，例如系统的制造商或出租人、是否支持系统外包、系统的保险公司名称和折旧方法等。您可
以为适用于所有系统的任何变量编写脚本，将脚本发送到所有管理系统并执行。系统所特有的资产信息可作为一个组编写成脚本，并发送到该管理型节点以便执行。例如，脚本可以为所有唯
一变量（例如所有者、主要用户的电话号码和资产标签等）指定值。批量载入唯一值的脚本可同时设置所有唯一变量，而不必通过系统的命令行逐个设置。
在许多情况下，CLI 使有非常明确任务的用户可以快速检索系统信息。如果用户想要查看所有系统组件的综合摘要，并将此摘要信息保存到一个文件中以便与以后的系统状态进行比较，CLI
即为理想的选择。
管理员可以使用 CLI 命令编写批处理程序或脚本以便在特定时间执行。这些程序可以在执行时捕获感兴趣的组件报告，例如捕获系统高使用率期间的风扇 RPM，与系统低使用率时的同一测
量数据进行比较。命令结果可以发送到一个文件，以便以后进行分析。报告可以帮助管理员获得信息，以用于调整使用方案、判断是否需要购买新的系统资源或了解故障组件的运行状况。
命令语法概览
命令的复杂性各不相同。最简单的命令只有 1 级命令。omhelp 命令就是一种简单命令。当您键入 omhelp 时，系统将显示主要 CLI 命令的列表。
更复杂一些的命令包含 1 级和 2 级命令。例如，所有的 about 命令都是具有 2 级复杂性的命令。omconfig about 和 omreport about 命令会显示简短的摘要。此摘要显示系统上安
装的系统管理软件的版本信息，例如 Server Administrator 1.x。
某些命令具有 1 级命令和 2 级命令以及一个名称=值对。请考虑使用以下指示 Server Administrator 的示例命令，以获得有关 Server Administrator 环境的详情：
omreport about details=true
1 级命令是 omreport，2 级命令是 about，以及名称=值对是
details=true。
许多命令均使用 1 级命令、2 级命令和 3 级命令，但不需要任何参数（名称=值对）。大多数 omreport 命令都属于这一类型。例如：
omreport system alertaction
命令会显示为系统上的组件配置的警报措施列表。
最复杂的命令具有所有三个命令级别和多个名称名称=值对。具有两个名称=值对的实例：
omconfig system assetinfo info=depreciation duration=3
具有九个名称=值对的实例：
omconfig system assetinfo info=acquisition
purchasecost=<n> waybill=<n> installdate=< 月日年 > purchasedate=< 月日年 > ponum=<n> signauth=< 文本 >
expensed=< 是 | 否 > costcenter=< 文本 >