User Guide

User Guide
使用 iDRAC SM-CLP 命令行界面: Integrated Dell Remote Access Controller固件版本1.2 用户指南

目录

使用 iDRAC SM-CLP 命令行界面

Integrated Dell™ Remote Access Controller固件版本1.2
用户指南

  使用 SM-CLP 进行系统管理

  iDRAC SM-CLP 支持

  SM-CLP 功能

  导航 MAP 地址空间

  使用 Show Verb

  iDRAC SM-CLP 示例

  用 Telnet 或 SSH 使用 LAN 上串行 (SOL)


本部分提供了有关 iDRAC 中 Server Management Workgroup (SMWG) Server Management Command Line Protocol (SM-CLP) 的信息。

注： 本部分假定您熟悉 Systems Management Architecture for Server Hardware (SMASH) 标准和 SMWG SM-CLP 规范。有关这些规范的详情，请参阅分布式管理任务小组 (DMTF) 网站 www.dmtf.org。

iDRAC SM-CLP 是由 DMTF 和 SMWG 推动的一项协议，提供了系统管理 CLI 实施的标准。定义的 SMASH 体系结构做了很多工作，旨在为更多标准系统管理组件建立基础。SMWG SM-CLP 是 DMTF 推动的整个 SMASH 工作中的一部分。

SM-CLP 提供了本地 RACADM 命令行界面的一部分功能，只不过访问路径不同。SM-CLP 在 iDRAC 中执行，而 RACADM 在 managed server 上执行。另外，RACADM 是一种 Dell 专用界面，而 SM-CLP 是业界标准界面。请参阅RACADM 和 SM-CLP 等价了解 RACADM 和 SM-CLP 命令的映射。

使用 SM-CLP 进行系统管理

iDRAC SM-CLP 使用户能够从命令行或脚本管理以下系统功能：

  • 服务器电源管理 — 打开、关闭或重新引导系统

  • 系统事件日志 (SEL) 管理 — 显示或清除 SEL 记录

  • iDRAC 用户帐户管理

  • Active Directory 配置

  • iDRAC LAN 配置

  • SSL 认证签名请求 (CSR) 生成

  • 虚拟介质配置

  • 在 Telnet 或 SSH 上 LAN 上串行 (SOL) 重定向

iDRAC SM-CLP 支持

SM-CLP 承载在 iDRAC 固件中并支持 telnet 和 SSH 连接。iDRAC SM-CLP 界面基于由 DMTF 组织提供的 SM-CLP 规范版本 1.0。

以下部分提供了 iDRAC 上 SM-CLP 功能的概览。

SM-CLP 功能

SM-CLP 规范提供了一组常用标准 SM-CLP verb，可通过 CLI 用于简单系统管理。

SM-CLP 提供了 verb 的概念，并旨在通过 CLI 提供系统配置功能。verb 表示要执行的操作，而目标确定了要运行操作的实体（或对象）。

以下是 SM-CLP 命令行的语法：

<verb> [<选项>] [<目标>] [<属性>]

表 11-1 提供了 iDRAC CLI 支持的 verb 的列表，各个命令的语法，以及 verb 支持的选项列表。

表 11-1.  支持的 SM-CLP CLI Verb 

Verb

说明

选项

cd

使用 shell 导航 Managed System 地址空间。

语法：

cd [选项] [目标]

–Cdefault, –Cexamine, –Chelp, –Coutput, –Cversion

delete

删除对象实例。

语法：

delete [选项] 目标

–Cexamine, –Chelp, –Coutput, –Cversion

dump

将二进制映像从 MAP 移至 URI。

dump -destination <URI> [选项] [目标]

–Cdestination, –Cexamine, –Chelp, –Coutput, –Cversion

exit

从 SM-CLP shell 会话退出。

语法：

exit [选项]

–Chelp, –Coutput, –Cversion

help

显示 SM-CLP 命令帮助。

help

-examine, -help, -output, -version

load

将二进制映像从 URI 移至 MAP。

语法：

load -source <URI> [选项] [目标]

–Cexamine, –Chelp, –Coutput, –Csource, –Cversion

reset

重设目标。

语法：

reset [选项] [目标]

–Cexamine, –Chelp, –Coutput, –Cversion

set

设置目标属性

语法：

set [选项] [目标] <属性名称>=<值>

–Cexamine, –Chelp, –Coutput, –Cversion

show

显示目标属性、verb 和子目标。

语法：

show [选项] [目标] <属性名称>=<值>

-all, -default, –Cdisplay, –Cexamine, –Chelp, –Clevel, –Coutput, –Cversion

start

启动目标。

语法：

start [选项] [目标]

–Cexamine, –Cforce, –Chelp, –Coutput, –Cversion

stop

关闭目标。

语法：

stop [选项] [目标]

–Cexamine, –Cforce, –Chelp, –Coutput, –Cstate, –Cversion, –Cwait

version

显示目标的版本属性。

语法：

version [选项]

–Cexamine, –Chelp, –Coutput, –Cversion

表 11-2 说明 SM-CLP 选项。有些选项有简写格式，如表中所示。

表 11-2.  支持的 SM-CLP 选项 

SM-CLP 选项

说明

–Call, –Ca

指示 verb 执行所有可能的功能。

-destination

在 dump 命令中指定存储映像的位置。

语法：

-destination <URI>

-display, -d

筛选命令输出。

语法：

-display <属性 | 目标 | verb>[, <属性 | 目标 | verb>]*

-examine, -x

指示命令处理器在不执行命令的情况下验证命令语法。

–Chelp, –Ch

显示 verb 帮助。

–Clevel, -l

指示 verb 在目标上以指定目标以下的级别操作。

语法：

-level <n | all>

–Coutput, –Co

指定输出的格式。

语法：

-output <text | clpcsv | clpxml>

-source

在 load 命令中指定映像的位置。

语法：

-source <URI>

–Cversion, –Cv

显示 SMASH-CLP 版本号。

导航 MAP 地址空间

注： 斜杠 (/) 和反斜杠 (\) 在 SM-CLP 地址路径中可以互换。不过，命令行末尾的反斜杠会使命令在下一行继续并在命令分析中忽略。

可以使用 SM-CLP 管理的对象由称为可管理性访问点 (MAP) 地址层次空间排列的目标表示。地址路径指定从地址空间根到对象的路径。

根目标由斜杠 (/) 或反斜杠 (\) 表示。这是登录 iDRAC 时的默认起始点。使用 cd verb 从根向下导航。例如，要导航到系统事件日志 (SEL) 中的第三个记录，输入以下命令：

->cd /system1/sp1/logs1/record3

输入不带目标的 cd verb 以查找在地址空间中的当前位置。..和 .缩写的作用与在 Windows 以及 Linux 中相同：..指父级，而 .指当前级。

目标

表 11-3 提供了 SM-CLP 可用的目标列表。

表 11-3.  SM-CLP 目标

目标

定义

/system1/

Managed System 目标。

/system1/sp1

服务处理器。

/system1/sol1

LAN 上串行目标。

/system1/sp1/account1 through /system1/sp1/account16

十六个本地 iDRAC 用户帐户。account1 是根帐户。

/system1/sp1/enetport1

iDRAC NIC MAC 地址。

/system1/sp1/enetport1/lanendpt1/
ipendpt1

iDRAC IP、网关和网络掩码设置。

/system1/sp1/enetport1/lanendpt1/
ipendpt1/dnsendpt1

iDRAC DNS 服务器设置。

/system1/sp1/group1 through /system1/sp1/group5

Active Directory 标准架构组。

/system1/sp1/logs1

日志收集目标。

/system1/sp1/logs1/record1

Managed System 上的单独 SEL 记录实例。

/system1/sp1/logs1/records

Managed System 上的 SEL 目标。

/system1/sp1/oemdell_racsecurity1

用来生成认证签名请求的参数存储。

/system1/sp1/oemdell_ssl1

SSL 认证请求状态。

/system1/sp1/oemdell_vmservice1

虚拟介质配置和状态。

使用 Show Verb

要了解有关使用目标的详情，请使用 show verb。此 verb 显示目标的属性、子目标和该位置允许的 SM-CLP verb 的列表。

使用 -display 选项

show ®Cdisplay 选项允许限制命令的输出为一个或多个属性、目标和 verb。例如，要只显示当前位置的属性和目标，使用以下命令：

show -d properties,targets /system1/sp1/account1

要只列出某些属性，按以下命令予以限定：

show -d properties=(userid,username) /system1/sp1/account1

如果只想显示一个属性，可以省略括号。

使用 -level 选项

show -level 选项在指定目标以下的级别执行 show。例如，如果想查看 /system1/sp1 下帐户 1 到帐户 16 的 username 和 userid 属性，可以输入以下命令：

show -l 1 -d properties=(userid,username) /system1/sp1/account*

要查看地址空间的所有目标和属性，使用 -l all 选项，如以下命令：

show -l all -d properties /

使用 -output 选项

-output 选项指定 SM-CLP verb 输出的四种格式之一：text、clpcsv、keyword 和 clpxml。

默认格式为 text，是最可读的输出。clpcsv 格式是逗号分隔值格式，适合于载入电子表格程序。keyword 格式以每行关键字=值对列表输出信息。clpxml 格式是 XML 文档，包含 response XML 元素。DMTF 指定了 clpcsv 和 clpxml 格式，其规范可以在 DMTF 网站 www.dmtf.org 找到。

以下示例显示了如何以 XML 输出 SEL 内容：

show -l all -output format=clpxml /system1/sp1/logs1

iDRAC SM-CLP 示例

以下小节提供了使用 SM-CLP 执行以下操作的示例：

  • 服务器电源管理

  • SEL 管理

  • 映射目标导航

  • 显示系统属性

  • 设置 iDRAC IP 地址、子网掩码和网关地址

有关使用 iDRAC SM-CLP 界面的信息，请参阅iDRAC SMCLP 属性数据库。

服务器电源管理

表 11-4 提供了使用 SM-CLP 在 Managed Server 上执行电源管理操作的示例。

表 11-4.  服务器电源管理操作 

操作

语法

使用 SSH 界面登录 iDRAC

>ssh 192.168.0.120
>login: root
>password:

关闭服务器的电源

->stop /system1
system1 已成功停止

将服务器从电源关闭状态打开

->start /system1
system1 已成功启动

重新引导服务器

->reset /system1
system1 已成功重设

SEL 管理

表 11-5 提供了使用 SM-CLP 在 Managed System 上执行 SEL 相关操作的示例。

表 11-5.  SEL 管理操作 

操作

语法

查看 SEL

->show /system1/sp1/logs1

Targets:
record1
record2
record3
record4
record5

Properties:
Description=IPMI SEL
MaxNumberOfRecords=512
CurrentNumberOfRecords=5

Verbs:
cd
delete
exit
help
show
version

查看 SEL 记录

->show /system1/sp1/logs1/record4
ufip=/system1/sp1/logs1/log1/record4

Properties:
Caption=Not defined
Description=Backplane Drive 0: drive slot sensor for Backplane, drive presence was asserted
ElementName=Not Supported
LogCreationClassName=CIM_RecordLog
LogName=IPMI SEL
CreationClassName=CIM_LogRecord
RecordID=4
MessageTimeStamp=16:37:10,January 13,2007

Verbs:
cd
exit
help
show
version

清除 SEL

->delete /system1/sp1/logs1
All records deleted successfully

映射目标导航

表 11-6 提供了使用 cd verb 导航映射的示例。在所有示例中，假定初始的默认目标为 /。

表 11-6.  映射目标导航操作 

操作

语法

导航到系统目标并重新引导

->cd system1
->reset

注： 当前默认目标为 /。

导航到 SEL 目标并显示日志记录

->cd system1
->cd sp1
->cd logs1
->show

->cd system1/sp1/logs1
->show

显示当前目标

->cd .

上移一级

->cd ..

退出 shell

->exit

设置 iDRAC IP 地址、子网掩码和网关地址

使用 SM-CLP 更新 iDRAC 网络属性是一个两部分过程：

  1. 设置 NIC 属性新值，位置为 /system1/sp1/enetport1/lanendpt1/ipendpt1：

    • oemdell_nicenable — 设置为 1 启用 iDRAC 网络，0 禁用

    • ipaddress — IP 地址

    • subnetmask — 子网掩码

    • oemdell_usedhcp — 设置为 1 启用使用 DHCP 设置 ipaddress 和 subnetmask 属性，0 设置静态值

  2. 通过将 committed 属性设置为 1 提交新值。

无论何时 commit 属性的值为 1，属性的当前设置都活动。如果更改任何属性，commit 属性会重设为 0，表示值尚未提交。

注： commit 属性只影响在 /system1/sp1/enetport1/lanendpt1/ipendpt1 MAP 位置的属性。所有其它 SM-CLP 命令会立即生效。
注： 如果使用本地 RACADM 设置 iDRAC 网络属性，您的更改会立即生效，因为本地 RACADM 不依赖于网络连接。

提交更改后，新网络设置会生效，造成 telnet 或 ssh 会话终止。通过引入提交步骤，可以延迟会话的终结直至完成所有 SM-CLP 命令。

表 11-7 提供了使用 SM-CLP 设置 iDRAC 属性的示例。

表 11-7.  使用 SM-CLP 设置 iDRAC 网络属性

操作

语法

导航到 iDRAC NIC 属性位置

->cd /system1/sp1/enetport1/lanendpt1/ipendpt1

设置新 IP 地址

->set ipaddress=10.10.10.10

设置子网掩码

->set subnetmask=255.255.255.255

打开 DHCP 标志

->set oemdell_usedhcp=1

启用 NIC

->set oemdell_nicenable=1

提交更改

->set committed=1

使用 SM-CLP 更新 iDRAC 固件

要使用 SM-CLP 更新 iDRAC 固件，必须知道 Dell 更新软件包的 TFTP URI。

按照这些步骤使用 SM-CLP 更新固件：

  1. 使用 telnet 或 SSH 登录 iDRAC。

  2. 通过输入以下命令检查当前固件版本：

version

  1. 输入以下命令：

load -source tftp://<tftp-服务器>/<更新-路径> /system1/sp1

其中 <tftp-服务器> 是 TFTP 服务器的 DNS 名称或 IP 地址，而 <更新-路径> 是 TFTP 服务器上更新软件包的路径。

telnet 或 SSH 会话将会终止。可能需要等待几分钟固件更新才能完成。

  1. 要验证写入新固件，请启动新 telnet 或 SSH 会话并再次重新输入 version 命令。

用 Telnet 或 SSH 使用 LAN 上串行 (SOL)

在 Management Station 上使用 Telnet 或 SSH 控制台连接到 iDRAC 并随后重定向 managed server 的串行端口到控制台中。此功能是 IPMI SOL 的替代，该方式要求 solproxy 一类的公用程序在网络数据包间转换串行数据流。iDRAC SOL 方式消除了额外公用程序的需要，因为串行到网络转换是在 iDRAC 中进行的。

使用的 Telnet 或 SSH 控制台应该能解释并响应来自 Managed Server 串行端口的数据。串行端口通常附加到仿真 ANSI- 或 VT100- 终端的 Shell 上。

使用 Telnet，连接到 IPMI LAN SOL 端口—端口 2100。串行控制台自动重定向到 Telnet 控制台。

使用 SSH 或 Telnet，按照连接到 SM-CLP 的方式连接到 iDRAC。SOL 重定向可以随后从 /system1/sol1 目标启动。

请参阅安装 Telnet 或 SSH 客户端了解有关使用带有 iDRAC 的 Telnet 和 SSH 客户端的详情。

将 SOL Over Telnet 用于 Microsoft Windows 上的 HyperTerminal

  1. 选择"Start"（开始）®"All Programs"（所有程序）® "Accessories"（附件）®"Communications"（通讯）® "HyperTerminal"（超级终端）。

  2. 为连接输入名称，选择图标，并单击"OK"（确定）。

  3. 从"Connect using"（连接使用）字段的列表中选择 TCP/IP (Winsock)。

  4. 在"Host address"（主机地址）字段中输入 iDRAC 的 DNS 名称或 IP 地址。

  5. 在"Port number"（端口号）字段中输入 Telnet 端口号。

  6. 单击 OK（确定）。

要结束 SOL 会话，单击 HyperTerminal 断开连接图标。

将 SOL Over Telnet 用于 Linux

要从 Linux Management Station 上的 Telnet 启动 SOL，请执行这些步骤：

  1. 启动 shell。

  2. 使用以下命令连接到 iDRAC：

telnet <iDRAC-ip-地址>

注： 如果更改了 Telnet 服务的默认端口号（端口 23），应将端口号添加到 telnet 命令结尾。
  1. 输入以下命令以启动 SOL：

start /system1/sol1

这会连接到 Managed Server 的串行端口。

准备好退出 SOL 后，键入 <Ctrl>+] （按住 Ctrl 并键入右方括号，然后松开）。Telnet 提示符将会显示。键入 quit 退出 Telnet。

使用 SOL Over SSH

/system1/sol1 目标允许将 Managed Server 的串行端口重定向到 SSH 控制台。

  1. 使用 OpenSSH 或 PuTTY 连接到 iDRAC。

  2. 输入以下命令以启动 SOL：

start /system1/sol1

这会连接到 Managed Server 的串行端口。SM-CLP 命令不再可用。

准备退出 SOL 重定向时，按 <Enter>、<Esc>，然后按 <T>（按顺序逐个按这些键）。将关闭 SSH 会话。

一旦启动 SOL，就不能返回 SM-CLP。必须退出 SSH 会话并启动新会话以使用 SM-CLP。

目录

 

Support
Home Users
Small Businesses
Enterprise IT
Community
Company Information
My Account

© 2012 Dell | Terms of Sale | Unresolved Issues | Privacy | Site Map | Feedback

Large Text
snWEB1