Sun Management Center CLI 概述

Sun Management Center 命令行界面 (Command-line Interface, CLI) 是字符驱动的控制台应用程序，用于监视和管理您的系统。CLI 提供了几个有用的功能：

• 低系统开销 – 尽管 CLI 提供了 Java 控制台和 Web 控制台的大多数功能，但 CLI 并不需要位图图形。因此 CLI 可以通过低带宽连接在简单的数据终端设备上运行。但是，CLI 并不支持需要 GUI 的功能（例如物理视图或绘图）。

• 批处理模式处理 – CLI 支持基本的脚本编辑功能，使 CLI 能够在批处理模式下获取文件中的命令输入。

• 可配置的输出格式 – 用户可以配置 CLI 输出的格式。纯文本输出能够与其它基于文本的工具兼容。对于扩展命令，可以指定以 HTML 格式输出。

• 帮助 – 可以在 CLI 中使用 CLI 命令的联机帮助。

使用 CLI 可以执行以下任务：

• 创建拓扑对象（例如域、组和实体），以及检索有关这些对象的拓扑信息。

• 检索和操作被管理对象的特性或属性。

• 加载、卸载、启用和禁用 Sun Management Center 代理中的模块。

• 在 Sun Management Center 代理上设置和运行警报操作、检索警报信息以及确认或删除警报。

---

注 –

（在 Solaris 上）您可以使用参数文件自动登录到控制台。如果参数文件包含用户名和密码，则该文件的权限必须为 400。否则便无法通过 CLI 自动登录。

---

系统要求

可以使用以下任一系统配置，从用户终端会话访问 CLI：

• 运行以下版本 Solaris 操作系统的 UNIX® 工作站：Solaris 2.6、Solaris 7、Solaris 8、Solaris 9 或 Solaris 10。

• 运行以下操作系统的 UNIX 工作站：Red Hat、SuSE/JDS Linux（内核版本 2.4 和 2.6）。

• 运行以下操作系统的 PC：Windows 98、Windows 2000、Windows XP 或 Windows NT。

CLI 交互模式

CLI 支持以下两种交互模式：

• 会话模式 – 会话模式是可交互的。登录到 Sun Management Center 服务器后，可以输入命令并接收输出，直到明确地在服务器上注销。

• 批处理模式 – CLI 可以连接到服务器，并执行 filename 文件中包含的命令，其中 filename 是包含 CLI 命令的文件的名称。

配置 CLI 批处理模式

通过修改 cli.properties 文件（位于 /opt/SUNWsymon/cli 目录下），可以对 CLI 批处理模式进行配置。此文件包含 9 个可配置参数。

表 20–1 介绍了这些可配置参数。

表 20–1 用于配置 CLI 批处理模式的参数

参数	说明	默认值
process_time_out	如果超出该时间，将删除系统中的 CLI 后端进程。	Process time-out 24 hrs process_time_out = 86400 (in seconds)
uds_dgram_wait_time	DGRAM 客户机等待 CLI 后端进程响应的时间。如果客户机在指定的时间内没有接收到任何响应，将显示如下一则错误消息：“Error receiving data from Backend”。	UDS DGRAM wait time in seconds uds_dgram_wait_time = 300
uds_stream_wait_time	STREAM 客户机等待 CLI 后端进程响应的时间。如果客户机在指定的时间内没有接收到任何响应，将显示如下一则错误消息：“Error receiving data from Backend”。	UDS STREAM wait time in seconds uds_stream_wait_time = 180
out_file	此文件包含当前运行的 CLI 后端进程的详细信息。此文件的格式如下：  <user>:<hostname>:<C Process ID>:<Java Process ID>	User & process information file out_file = /var/opt/SUNWsymon/cli/process-file
socket_pathclnt	此文件包含客户机代理 UDS 文件的路径。已处理的 CLI 命令的输出将发送到此文件。	Path to uds file socket_pathclnt = /var/opt/SUNWsymon/cli/broker_uds_client_file
cli_log_path	此文件包含 CLI 日志文件的路径。	Location of CLI log file cli_log_path = /tmp/sunmclog/cli
cli_log_file	CLI 日志文件的名称。	Location of backend(broker) log file cli_log_file = /tmp/sunmclog/cli/cli-batch-mode-log
uds_file_path	此路径参数包含 STREAM 和 DGRAM UDS 文件的位置。	Path of the uds files uds_file_path = /var/opt/SUNWsymon/cli/
log_level	指定要使用的日志级别。对于生产环境，请将此日志级别设置为 ERROR。对于调试环境，请将此日志级别设置为 INFO。	Batch mode log level [options : INFO|ERROR] log_level=ERROR

CLI 命令和参数概述

本节概述了 CLI 命令和参数。

CLI 命令概述

CLI 命令可分为两种类型：基本命令和扩展命令。

• 基本命令用于修改执行其他 CLI 命令的环境。使用基本命令可以设置参数值、定义命令别名、检查命令状态或登录到服务器以及在服务器上注销。基本命令始终在前台运行。

• 扩展命令用于查询或修改被管理对象的拓扑结构和它们的属性（property 和 attribute）。使用扩展命令可以执行以下几个功能：

  • 在被管理对象的拓扑结构中定位被管理对象

  • 启用或禁用模块

  • 确认或删除警报

  缺省情况下，扩展命令在后台运行。也可以将扩展命令配置为在前台运行。

在会话模式下，命令在前台或后台均可执行。

• 前台 – 在前台执行的命令会一直运行到结束，并直接将输出发送至屏幕，除非经过重定向。在前台，一次只能运行一条命令。基本命令只能在前台运行；扩展命令默认情况下在后台运行，但是可以将其配置为在前台运行。

• 后台 – 在后台执行的命令以异步方式运行，默认情况下不向屏幕发送输出或诊断信息。输出被缓存起来，可以在以后接收到明确请求时显示。与 UNIX shell 不同，在后台一次只能运行一条扩展命令。在后台运行扩展命令时，可以在前台运行任意多条基本命令。缺省情况下，扩展命令在后台运行，但也可指定其在前台运行。基本命令不能在后台运行。

CLI 也支持使用别名。可以为更复杂的命令及其参数定义缩写或别名。可以在不同的 CLI 会话中使用用户定义的别名。

CLI 参数概述

CLI 参数是成对的名称和值：每个参数都包含一个名称和一个值。某些参数内置于 CLI 中。其名称和值的含义在 CLI 中进行了预定义。您可以定义其它参数，这些参数也称为变量。某些参数是全局范围参数。全局参数影响特定会话中运行的所有 CLI 命令的执行情况。其它参数则特定于某条命令或命令组。

输入和输出功能

CLI 提供了几个输入和输出功能。

• 输入

  • 在会话模式下，CLI 以交互方式接受从键盘输入的命令。

  • 在批处理模式下，CLI 可以执行 CLI 命令文件（其名称在 shell 命令行中指定）中包含的命令。

• 输出

  • 默认情况下，基本命令的输出会显示在屏幕上。

  • 默认情况下，扩展命令的输出在后台被缓存，直到用户请求获得该输出。

  • 可以将基本命令和扩展命令的输出重定向到指定的文件。

  • 可以将命令和参数保存到日志文件中，以便日后用作批处理模式下的 CLI 输入。

    ---

    注 –

    要将日志文件用作批处理模式下 CLI 的输入，必须对此文件进行编辑。删除时间戳以及出现在日志文件中实际命令和参数之前的任何信息。

    ---

• 格式

  • 可以指定输出显示的行数。

  • 对于多列输出，可以指定要显示的列。

  • 除纯文本输出以外，还可以为某些命令指定 XML 或HTML 格式的输出。

CLI 命令帮助

CLI 为每条 CLI 命令都提供了联机帮助。可以在 CLI 中使用 CLI 帮助。CLI 帮助不要求具备 GUI。帮助提供了了每条命令的用法说明，还列出了与该命令相关的参数。