返回目录页

使用 RACADM 命令行界面

Dell Remote Access Controller 5 固件版本 1.30 用户指南

  使用串行或 Telnet 控制台

  使用 RACADM

  配置多个 DRAC 5 卡

  使用 RACADM 公用程序配置 DRAC 5

  常见问题

串行/telnet/ssh 控制台提供一组 racadm 命令。racadm 命令提供对 DRAC 5 基于 Web 界面支持的基于文本功能的访问。

RACADM 使您能从本地或远程配置和管理 DRAC 5。RACADM 在 management station 和 managed system 上运行。RACADM 包括在 Dell Systems Console and Agent CD 中。

可以使用 RACADM 编写脚本来自动配置多个 DRAC 5。有关配置多个 DRAC 5 的详情，请参阅“配置多个 DRAC 5 卡”。

本节提供以下信息：

• 使用“serial”（串行）和 racadm 命令。请参阅“使用串行或远程登录控制台” 或 “使用 RACADM”
  
  
• 使用 racadm 命令配置 DRAC5
  
  
• 使用 racadm 配置文件配置多个 DRAC 5 卡
  
  

使用串行或远程登录控制台

可以使用 RACADM 或从串行 /telnet/ssh 控制台命令提示符远程运行表 9-1 中的串行命令。

登录 DRAC 5

配置完 management station 终端仿真软件和管理型节点 BIOS 后，执行下列步骤登录到 DRAC 5：

1. 使用 management station 终端仿真软件连接到 DRAC 5。
   
   
2. 输入 DRAC 5 用户名并按 <Enter>。
   
   

您已登录 DRAC 5。

启动文本控制台

通过 management station 终端软件以 Telnet 或 SSH 登录 DRAC 5 后，可以使用 connect com2 telnet/SSH 命令重定向 managed system 文本控制台。一次只支持一个 connect com2 客户端。

要连接到 managed system 文本控制台，请打开 DRAC 5 命令提示符（通过 telnet 或 SSH 会话显示）并键入：

connect com2

从串行会话，可以通过按 <Esc><Shift><Q> 连接 managed system 的串行控制台，该命令将 managed system 的串行端口直接连接到服务器的 COM2 端口并且不经过 DRAC 5。要将 DRAC 5 重新连接到串行端口，请按 <Esc><Shift><9>。管理型节点 COM2 端口和 DRAC 5 串行端口的波特率必须相同。

connect -h com2 命令显示等待键盘输入或来自串行端口的新字符前串行历史记录缓冲区的内容。

注： 使用 -h 选项时，客户端和服务器终端仿真类型（ANSI 或 VT100）必须相同；否则，输出可能混淆。此外，将客户端终端行设置为 25。

历史记录缓冲区的默认（以及最大）大小为 8192 个字符。可以使用以下命令将此数设置为更小的值：

racadm config -g cfgSerial -o cfgSerialHistorySize <数字>

使用 RACADM

可以从串行或 telnet 控制台命令提示符或通过正常的命令提示符从本地或远程运行 RACADM 命令。

使用 racadm 命令配置 DRAC 5 属性，执行远程管理任务或恢复崩溃系统。

要使用 RACADM 显示 racadm 子命令列表，请键入：

racadm help

子命令列表包括 DRAC 5 支持的所有命令。

不带选项的 racadm 命令显示常规用户信息。键入 racadm help 显示所有可用子命令列表。键入 racadm help <子命令> 显示该子命令的语法和命令行选项。

以下部分介绍了如何使用 racadm 命令。

远程使用 RACADM

注： 使用 racadm 远程功能前请配置 DRAC 5 上的 IP 地址。有关设置 DRAC 5 的详情和相关说明文件的列表，请参阅“安装和设置 DRAC 5”。

RACADM 提供远程功能选项 (-r)，可以允许连接 managed system 和从远程控制台和 management station 执行 racadm 子命令。要使用远程功能，您需要有效用户名（-u 选项）和密码（-p 选项）和 DRAC 5 IP 地址。

注： 如果访问远程系统的系统在其默认的认证存储中没有 DRAC 认证，则在键入 racadm 命令时会显示一条信息。

Security Alert: Certificate is invalid - Name on Certificate is invalid or does not match site name（安全警报：证书无效 — 证书上的名称无效或不匹配站点名称）

“Enter "Y" to continue, or any other key to quit”（输入“Y”继续，或输入其它键退出）

注： racadm 远程功能只在 management station 上受支持。有关详情，请参阅 Dell 支持网站 support.dell.com 上的“Dell 系统软件支持值表”。

注： 使用 racadm 远程功能时，在使用涉及文件操作的 racadm 子命令的文件夹上必须具有写入权限，例如：

racadm getconfig -f <文件名>

或

racadm sslcertupload -t 1 -f c:\cert\cert.txt 子命令

RACADM 提要

racadm -r <RAC IP 地址> -u <用户名> -p <密码> <子命令> <子命令选项>

racadm -i -r <RAC IP 地址> <子命令> <子命令选项>

例如：

racadm -r 192.168.0.120 -u root -p calvin getsysinfo

racadm -i -r 192.168.0.120 getsysinfo

如果 RAC 的 HTTPS 端口号更改为非默认端口 (443) 的自定义端口，则必须使用下面的语法：

racadm -r <RAC IP 地址>:<端口> -u <用户名> -p <密码> <子命令> <子命令选项>

racadm -i -r <RAC IP 地址>:<端口> <子命令> <子命令选项>

RACADM 选项

表 9-1 列出了 racadm 命令的选项。

表 9-1. racadm 命令选项 

启用和禁用 RACADM 远程功能

注： 建议在本地系统上运行这些命令。

RACADM 远程功能默认启用。如果禁用，请键入下面的 racadm 命令启用：

racadm config -g cfgRacTuning -o cfgRacTuneRemoteRacadmEnable 1

要禁用远程功能，请键入：

racadm config -g cfgRacTuning -o cfgRacTuneRemoteRacadmEnable 0

RACADM 子命令

表 9-2 提供可在 RACADM 中运行的每个 racadm 子命令的说明。有关 racadm 子命令及语法和有效条目的详细列表，请参阅“RACADM 子命令概览”。

输入 RACADM 子命令时，请在命令前加上 racadm。例如：

racadm help

表 9-2. RACADM 子命令 

RACADM 错误信息

有关 racadm CLI 错误信息的信息，请参阅“常见问题”。

配置多个 DRAC 5 卡

使用 RACADM 可以配置一个或多个具有相同属性的 DRAC 5 卡。使用组 ID 和对象 ID 查询特定 DRAC 5 卡时，RACADM 从检索到的信息创建 racadm.cfg 配置文件。通过将文件导出到一个或多个 DRAC 5 卡，可以在最短时间内以相同属性配置控制器。

注： 某些配置文件包含独特的 DRAC 5 信息（如静态 IP 地址），在将文件导出到其他 DRAC 5 卡之前必须修改这些信息。

要配置多个 DRAC 5 卡，请执行以下过程：

1. 使用 RACADM 查询包含相应配置的目标 DRAC 5。
   
   

注： 生成的 .cfg 文件不包含用户密码。

打开命令提示符并键入：

racadm getconfig -f myfile.cfg

注： 使用 getconfig -f 将 RAC 配置重定向至文件仅对本地和远程 RACADM 界面支持。

2. 使用简单文本编辑器（可选）修改配置文件。
   
   
3. 使用新配置文件修改目标 RAC。
   
   

在命令提示符处键入：

racadm config -f myfile.cfg

4. 重设已配置的目标 RAC。
   
   

在命令提示符处键入：

racadm reset

getconfig -f racadm.cfg 子命令请求 DRAC 5 配置并生成 racadm.cfg 文件。如果需要，可以以其他名称配置该文件。

可以使用 getconfig 命令来执行以下操作：

• 显示组中的所有配置属性（由组名称和索引指定）
  
  
• 按用户名显示用户的所有配置属性
  
  

config 子命令将信息载入其他 DRAC 5。使用 config 与 Server Administrator 同步用户和密码数据库

初始配置文件 racadm.cfg，由用户命名。在以下实例中，配置文件命名为 myfile.cfg。要创建此文件，请在命令提示符处键入以下命令：

racadm getconfig -f myfile.cfg

注意： 建议使用简单文本编辑器编辑此文件。racadm 公用程序使用 ASCII 文本分析器。任何格式混淆分析器，都可能损坏 racadm 数据库。

创建 DRAC 5 配置文件

DRAC 5 配置文件<文件名>.cfg 用于 racadm config -f <文件名>.cfg 命令。该配置文件是简单文本文件，它允许用户创建配置文件（类似于 .ini 文件），并通过此文件配置 DRAC 5。用户可以使用任意文件名，并且不一定要使用 .cfg 扩展名（尽管本小节中的指定值采用了此扩展名）。

.cfg 文件可能：

• 已创建
  
  
• 从 racadm getconfig -f <文件名>.cfg 命令获得
  
  
• 从 acadm getconfig -f <文件名>.cfg 命令获得，然后编辑
  
  

注： 关于 getconfig 命令的信息，请参阅 “getconfig”。

系统将首先分析 .cfg 文件，以验证是否存在有效的组名和对象名，以及是否遵循了一些简单的语法规则。错误标记有在其中检测到错误的行号，并且有一条简单的信息解释该问题。系统将分析整个文件以检查其正确性，并显示所有错误。如果在 .cfg 文件中找到错误，写入命令将不传输到 DRAC 5。用户必须先改正所有错误才能使配置生效。-c 选项可以用于 config 子命令，它仅验证语法，而不会对 DRAC 5 执行写入操作。

创建 .cfg 文件时请使用以下原则：

• 如果分析器遇到索引组，则将由定位标记对象的值来区分不同的索引。
  
  

分析器将从 DRAC 5 读入该组的所有索引。配置 DRAC 5 时，该组内的任何对象都是简单修改。如果修改的对象代表新的索引，则该索引将在配置过程中在 DRAC 5 上创建。

• 用户无法在 .cfg 文件中指定所需的索引。
  
  

索引可以创建和删除，因此经过一段时间后，该组可能会变得不完整，其中包含了已使用和未使用的索引。如果索引存在，它将被修改。如果索引不存在，则使用第一个可用索引。此方法在用户不需要的地方添加索引条目以在所有管理的 RAC 之间实现精确索引匹配方面更加灵活。新用户将被添加至第一个可用的索引。如果所有索引均已满并且必须添加新的用户，则在一个 DRAC 5 上可以正确分析和运行的 .cfg 文件可能无法在其它 DRAC 5 上正确运行。

• 使用 racresetcfg 子命令配置所有具有相同属性的 DRAC 5 卡。
  
  

使用 racresetcfg 子命令将 DRAC 5 重设为初始默认值，然后运行 racadm config -f <文件名>.cfg 命令。确保 .cfg 文件中包含所有所需的对象、用户、索引和其它参数。

注意： 使用 racresetcfg 子命令将数据库和 DRAC 5 NIC 设置重设为初始默认设置并删除所有用户和用户配置。尽管根用户可用，但也会将其他用户的设置重设为默认设置。

分析规则

• 所有以“#”开头的行都被视为注释。
  
  

注释行必须从第一列开始。所有其它列中的“#”字符均只被视为 # 字符。

一些调制解调器参数可能在其字符串中包含 # 字符。不需要使用转义字符。可能需要从 racadm getconfig -f <文件名>.cfg 命令生成 .cfg，然后执行对其他 DRAC 5 racadm config -f <文件名>.cfg 命令，不添加转义字符。

实例：

#

# 这是一条命令。

[cfgUserAdmin]

cfgUserAdminPageModemInitString=<Modem init # not a comment>

• 所有组条目都必须由 "[" 和 "]"字符括起。
  
  

表示组名的起始 "["字符必须从第一列开始。必须先指定此组名，再指定组中的任何其它对象。没有关联的组名的对象将导致错误。配置数据将按照“DRAC 5 属性数据库组和对象定义”中的定义编入各组。

以下为组名、对象和对象属性值的实例。

实例：

[cfgLanNetworking] -{组名称}

cfgNicIpAddress=143.154.133.121 {对象名称}

• 所有参数都指定为“对象=值”对，在对象、= 或值之间不留空格。
  
  

值后的空格将忽略。值字符串内的空格保持不变。“=”右侧的所有字符都将保留原样（例如另一个“=”、“#”、“[”和“]”等）。这些字符都是有效的调制解调器对话脚本字符。

请参见上一列表项中的实例。

• .cfg 分析器忽略索引对象条目。
  
  

用户无法指定使用哪一个索引。如果索引已存在，则使用该索引，否则将在该组的第一个可用索引中创建新条目。

racadm getconfig -f <文件名>.cfg 命令将注释放置在索引对象前，允许用户查看包含的注释。

注： 用户可以使用下面的命令手动创建索引组： racadm config -g <组名称> -o <定位标记对象> -i <索引 1-16> <唯一定位标记名称>

• 索引组的行无法从 .cfg 文件删除。
  
  

用户必须使用以下命令手动删除索引对象：

racadm config -g <组名> -o <对象名> -i <索引 1 至 16> ""

注： 空字符串（两个 "" 字符表示）指示 DRAC 5 删除指定组的索引。

要查看索引组的内容，请使用以下命令：

racadm getconfig -g <组名> -i <索引 1 至 -16>

• 对于索引组，对象定位标记必须是 "[ ]" 对后的第一个对象。以下为当前索引组的实例：
  
  

[cfgUserAdmin]

cfgUserAdminUserName=<用户名称>

如果键入 racadm getconfig -f <myexample>.cfg，则命令为当前 DRAC 5 配置生成一个 .cfg 文件。可将此配置文件作为一个实例，并以此文件为基础创建您自己的 .cfg 文件。

修改 DRAC 5 IP 地址

修改配置文件中的 DRAC 5 IP 地址时，请删除所有不需要的“<变量>=值”条目。只有带有 “[” 和 “]” 的实际变量组标签保留，包括两个与 IP 地址更改相关的“<变量>=值”条目。

例如：

#

# Object Group "cfgLanNetworking"

#

[cfgLanNetworking]

cfgNicIpAddress=10.35.10.110

cfgNicGateway=10.35.10.1

此文件将更新为：

#

# Object Group "cfgLanNetworking"

#

[cfgLanNetworking]

cfgNicIpAddress=10.35.9.143

# comment, the rest of this line is ignored

cfgNicGateway=10.35.9.1

命令 racadm config -f myfile.cfg 分析文件并按行号识别错误。正确的文件将更新相应的条目。此外可以使用上面示例中的 getconfig 确认更新。

使用此文件下载企业范围内的更改或通过网络配置新系统。

注： “定位标记”是内部术语，不应在文件中使用。

使用 RACADM 公用程序配置 DRAC 5

注： 必须以用户 root 登录才能在远程 Linux 系统上执行 RACADM 命令。

DRAC 5 基于 Web 的界面是配置 DRAC 5 的最快方式。如果选择命令行或脚本配置或需要配置多个 DRAC 5，请使用随 DRAC 5 代理安装在 managed system 上的 RACADM。

要配置多个具有相同配置设置的 DRAC 5，请执行以下过程之一：

• 参考本节中的 Racadm 示例，创建一个 racadm 命令的批处理文件，然后在各个 managed system 上执行该批处理文件。
  
  
• 按照“racadm 子命令概览”中所述创建 DRAC 5 配置文件，然后在各个 managed system 上使用相同的配置文件执行 racadm config 子命令。

开始之前

最多可以在 DRAC 5 属性数据库中配置 16 个用户。手动启用 DRAC 5 用户前，请验证当前用户是否存在。如果配置新 DRAC 5 或运行 racadm racresetcfg 命令，则当前唯一用户为 root 密码 calvin。racresetcfg 子命令将 DRAC 5 重设回原始默认值。

注意： 使用 racresetcfg 命令时请小心，因为所有 配置参数将重设为初始默认值。任何之前的更改将丢失。

注： 可以随时启用和禁用用户。因此，用户在各个 DRAC 5 上可能会有不同的索引号。

要验证用户是否存在，请在命令提示符处键入以下命令：

racadm getconfig -u <用户名>

或

键入以下命令，每次仅查找索引 1 至 16 中的一个：

racadm getconfig -g cfgUserAdmin -i <索引>

注： 还可以键入 racadm getconfig -f <myfile.cfg> 并查看或编辑 myfile.cfg 文件，该文件包含所有 DRAC 5 配置参数。

系统将显示有些参数和对象 ID 以及它们的当前值。受关注的两个对象为：

# cfgUserAdminIndex=XX

cfgUserAdminUserName=

如果 cfgUserAdminUserName 对象没有值，则可以使用该索引编号（由 cfgUserAdminIndex 对象表示）。如果“=”后有名称，则该索引由该用户占用。

注： 使用 racadm config 子命令手动启用或禁用用户时，必须以 -i 选项指定索引。请注意上一示例中显示的 cfgUserAdminIndex 对象带有 “#” 字符。并且如果使用 racadm config -f racadm.cfg 命令指定任意数量的要写入的组/对象，将无法指定索引。新用户将被添加至第一个可用的索引。这便可以更灵活地使用相同设置配置多个 DRAC 5。

添加 DRAC 5 用户

要将新用户添加到 RAC 配置，可以使用一些基本命令。通常，执行以下过程：

1. 设置用户名。
   
   
2. 设置密码。
   
   
3. 设置用户权限。
   
   
4. 启用用户。
   
   

实例

下面的示例说明如何添加新用户 “John” 密码 “123456”，对 RAC 具有登录权限。

racadm config -g cfgUserAdmin -o cfgUserAdminUserName -i 2 john

racadm config -g cfgUserAdmin -o cfgUserAdminPassword -i 2 123456

racadm config -g cfgUserAdmin -i 2 -o cfgUserPrivilege 0x00000001

racadm config -g cfgUserAdmin -i 2 -o cfgUserAdminEnable 1

要验证，请使用以下命令之一：

racadm getconfig -u john

racadm getconfig -g cfgUserAdmin -i 2

删除 DRAC 5 用户

使用 RACADM 时，必须手动逐个禁用用户。不能使用配置文件删除用户。

下面的示例说明可用于删除 RAC 用户的命令语法：

racadm config -g cfgUserAdmin -o cfgUserAdminUserName -i <索引> ""

双引号空字符串 ("") 指示 DRAC 5 删除指定索引处的用户配置并将用户配置重设为初始出厂默认值。

检测电子邮件警报

RAC 电子邮件警报功能允许用户在 managed system 上发生重要事件时接收电子邮件警报。下面的示例演示如何测试电子邮件警报功能以确保 RAC 在网络上正确发送电子邮件警报。

racadm testemail -i 2

注： 确保检测电子邮件警报功能前 SMTP 和电子邮件警报设置已配置。有关详情请参阅“配置电子邮件警报” 。

监测 RAC SNMP 陷阱警报功能

RAC SNMP 陷阱警报功能允许 SNMP 陷阱侦听器接收 managed system 上发生的系统事件陷阱。

下面的示例演示用户如何测试 RAC 的 SNMP 陷阱警报功能。

racadm testtrap -i 2

测试 RAC SNMP 陷阱警报功能前，请确保正确配置 SNMP 和陷阱设置。请参阅“testtrap”和“testemail”子命令说明配置这些设置。

启用带有权限的 DRAC 5 用户

要启用具有特定管理权限（基于角色授权）的用户，首先请通过执行“开始之前”中的步骤找到一个可用用户索引。然后输入以下命令行，并在其中输入新的用户名和密码。

注： 有关特定用户权限的有效位掩码值列表，请参阅表 B-2。默认权限值为 0，表示用户没有启用任何权限。

racadm config -g cfgUserAdmin -o cfgUserAdminPrivilege -i <索引> <用户权限位掩码值>

配置 DRAC 5 网络属性

要生成可用网络属性的列表，请键入以下命令：

racadm getconfig -g cfgLanNetworking

要使用 DHCP 获得 IP 地址，请使用下面的命令写入对象 cfgNicUseDhcp 并启用此功能：

racadm config -g cfgLanNetworking -o cfgNicUseDHCP 1

此命令提供的配置功能与引导期间提示您输入 <Ctrl><e> 时选件 ROM 所提供的功能一样。有关使用 option ROM 配置网络属性的详情，请参阅“配置 DRAC 5 网络属性”。

以下实例介绍如何使用命令配置所需的 LAN 网络属性。

racadm config -g cfgLanNetworking -o cfgNicEnable 1

racadm config -g cfgLanNetworking -o cfgNicIpAddress 192.168.0.120

racadm config -g cfgLanNetworking -o cfgNicNetmask 255.255.255.0

racadm config -g cfgLanNetworking -o cfgNicGateway 192.168.0.120

racadm config -g cfgLanNetworking -o cfgNicUseDhcp 0

racadm config -g cfgLanNetworking -o cfgDNSServersFromDHCP 0

racadm config -g cfgLanNetworking -o cfgDNSServer1 192.168.0.5

racadm config -g cfgLanNetworking -o cfgDNSServer2 192.168.0.6

racadm config -g cfgLanNetworking -o cfgDNSRegisterRac 1

racadm config -g cfgLanNetworking -o cfgDNSRacName RAC-EK00002

racadm config -g cfgLanNetworking -o cfgDNSDomainNameFromDHCP 0

racadm config -g cfgLanNetworking -o cfgDNSDomainName MYDOMAIN

注： 如果 cfgNicEnable 设置为 0，则禁用 DRAC 5 LAN，即使启用了 DHCP。

DRAC 模式

DRAC 5 可以配置为三种模式：

• 专用
  
  
• 共享
  
  
• 与故障转移共享
  
  

表 9-3 提供每个模式的说明。

表 9-3. DRAC 5 NIC 配置

常见问题

表 9-4 列出常见问题。

表 9-4. 使用串行和 racadm 命令：常见问题 

返回目录页