Dell EMC OpenManage Enterprise Modular Edition for PowerEdge MX7000 Chassis RACADM Command Line Reference Guide July 2021 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2018 -2021 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Revision history Date Document revision Description of changes April 2021 A00 v1.30.00 - Updates for new features and enhancements July 2021 A01 v1.30.
Contents Revision history..........................................................................................................................................................................3 Chapter 1: Introduction................................................................................................................. 6 New in this release.............................................................................................................................................................
cfgDNSRacName (Read or Write).......................................................................................................................... 32 cfgDNSDomainName (Read or Write)................................................................................................................... 32 cfgDNSDomainNameFromDHCP (Read or Write).............................................................................................. 32 cfgStorageModule....................................................
1 Introduction This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions for Dell EMC OpenManage Enterprise Modular (OME – Modular). Topics: • • • • New in this release Supported RACADM Interfaces RACADM Command Options Other documents you may need New in this release 1.30.10 ● Added the output option, Power Supply Type to the commands,getpbinfo and getsensorinfo. 1.30.
NOTE: For MX systems, if the TLS 1.2 is not enabled in the browser, remote racadm commands fail. NOTE: The CLI interface does not support the special characters—'&', '|','`','>','<', '$(', '$\{', 'sudo', 'lsudo', 'lpath', and 'history'. RACADM Command Options Table 1. Details of RACADM command options Option Description -r Specifies the controller’s remote IP address. -u Specifies the user name that is used to authenticate the command transaction.
Table 3. List of documents (continued) Name of the document Brief introduction of the document OpenManage Enterprise and OpenManage Enterprise – Modular RESTful API Guide This document provides information about integrating your applications with OpenManage Enterprise Modular, using the RESTful API commands. Integrated Dell Remote Access Controller (iDRAC) User’s Guide This document provides information about installation, configuration, and maintenance of the iDRAC on managed systems.
2 RACADM sub command details This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
● # (pound) ● ASCII code 32 (space) NOTE: The - (dash) character cannot be the first character of the string, regardless of whether the string is quoted. There are different escaping rules for double quotation marks. There are different escaping rules for using single quotation mark and double quotation marks.
arp chassisaction config ...
Table 4. racadm arp (continued) Address HWtype HWaddress Flags Mask Iface 192.168.0.121 ether 90:b1:1c:f4:34:f4 C pub chassisaction Description Runs the turn on, turn off, power cycle, or reset operation. Synopsis Input racadm chassisaction [-m ] ● -m—Must be one of the following values: ○ chassis—Default state if -m is not specified.
● View members present in a group: racadm chassisgroup view members racadm chassisgroup view members --pending racadm chassisgroup view members --discovered racadm chassisgroup view groups ● Executes on a stand-alone, adds a stand-alone chassis to the group: racadm chassisgroup add -g ● Executes on a standalone using lead IP, adds a stand-alone chassis to the group: racadm chassisgroup add -l 192.168.0.1 ● Admits a chassis to the chassis group racadm chassisgroup admit -m 192.168.0.
● ● ● ● Input ○ CSEC—Security ○ CMON—Monitoring ○ CDPY—Deployment ○ CREP—Reports ○ CGRP—Groups ○ CDIS—Discovery ○ CINV—Inventory ○ CGEN—Generic ○ CUPD—Firmware update ○ CFWS—Setup ○ CUSR—User audit messages ○ CJOB—Job info ○ CMSC—Miscellaneous -q—The sequence number from which the records must be displayed. Records older than this sequence number are displayed. -n—Specifies the number of records that must be displayed. If the number is not specified, the recent 25 records are displayed.
Example NA NOTE: During a failover, the chassis power state on the OME - Modular GUI is displayed as "off". The original power state is displayed after the inventory is refreshed. config Description Modifies the configuration properties of the management module. NOTE: Use racadm config command to set basic attributes such as IP address attributes, to access the system.
● -m—The option must be one of the following values: ○ server-—where n = 1-8 ○ switch-—where n = 1-6 CAUTION: When run from the OME–Modular serial console, the connect -b option stays connected until the management module resets or the serial console is terminated. This connection is a potential security risk. NOTE: The racadm connect to server prompts you to enter the iDRAC credentials for connecting to the server.
● -a—[server|switch]—applies options to all modules present in the chassis of the given module type; if specified must be one of the following values: ○ server ○ switch If the module type is not specified, the default type is server. NOTE: Switches must support Ethernet management. ● -u—the username for servers must be 'root'. ● -p—password for the given username. For a server, the password must be 1-20 characters with ASCII value in the 32-126 range.
● Set SNMPv1 community string for switch-5 racadm deploy -m switch-5 -v SNMPv1 CommStrPart1,CommStrPart2,CommStrPart3 ro ● Set root password for all servers racadm deploy -a -u root -p NOTE: Follow the password guidelines to set the root password. For more information regarding the password guidelines, see the Dell EMC OpenManage Enterprise-Modular Edition for PowerEdge MX7000 Chassis User's Guide.
Input ● ● ● ● -g—Specifies the configuration group to display -o—Specifies the configuration object to display. This option is used with -g. -i—Specifies the index of indexed group. This option is used with -g. -m—The must have one of the following values: ○ storage-—Where n = 1 to 8 NOTE: The storage- option is available only for cfgStorageModule. ● -h—Displays all the available configuration groups.
● Display status of fan module 3 in the chassis. racadm getmodinfo -m fan-3 getniccfg Description Displays the network settings for modules. Synopsis racadm getniccfg [-m ] Input -m—The must be one of the following values: ● chassis—Default state if -m is not specified.
Used Power in EPP Pool EPP Percent - Available = Not Applicable = Not Applicable [Chassis Power Supply Status Table]
PS1 -48 PS2 -48 PS3 -48 PS4 -48 PS5 -48 PS6 -48 V V V V V V PSU.Slot.1 3000 W PSU.Slot.2 3000 W PSU.Slot.3 3000 W PSU.Slot.4 3000 W PSU.Slot.5 3000 W PSU.Slot.
Chassis Power State Overall Power Health Redundancy = ON = Not OK = No [System Power Policy Configuration] System Input Power Cap Redundancy Policy Dynamic PSU Engagement Enabled = Disabled = None = Not Applicable [Power Budgeting] System Input Max Power Capacity Input Redundancy Reserve Input Power Allocated to Servers Input Power Allocated to Chassis Infrastructure Total Input Power Available for Allocation Standby Input Power Capacity = = = = = = 11571 W Not Applicable Not Applicable Not Applicable
OK PWR Not OK PWR N/A PWR OK PWR Not OK PWR N/A 2 3 4 5 6 AC AC AC AC AC AC PS-2 Input Lost PS-3 Slot Empty PS-4 Online PS-5 Configuration Error PS-6 Slot Empty ● Chassis with DC power supply type FanSpeed rpm FanSpeed rpm FanSpeed rpm FanSpeed rpm FanSpeed rpm FanSpeed rpm FanSpeed rpm FanSpeed rpm FanSpeed rpm Temp 30 43 Temp 28 43 Temp 27 43 Temp 27 38 Temp 28 43 Temp 28 43 Temp 28 38 PWR OK PWR OK PWR OK PWR OK 24 RACADM sub co
PWR PWR Example OK OK 5 6 DC DC PS-5 Online PS-6 Online racadm getsensorinfo -c Sensor Type: Fan 1 Fan-1 2 Fan-2 3 Fan-3 4 Fan-4 5 Fan-5 6 Fan-6 7 Fan-7 8 Fan-8 9 Fan-9 Not OK OK OK OK OK Not OK OK OK OK N/A rpm 17174 rpm 17238 rpm 17081 rpm 14499 rpm N/A rpm 14502 rpm 14505 rpm 14479 rpm Sensor Type: Temp 1 Chassis Inlet Temperature 3 43 2 Sled 2 Inlet Temperature 3 43 3 Sled 3 Inlet Temperature 3 38 4 Sled 4 Inlet Temperature 3
Example ● Displays Chassis Information racadm getsysinfo -c ● Displays MM Information racadm getsysinfo -d ifconfig Description Synopsis Displays the network interface information. racadm ifconfig ping Description Synopsis Sends ICMP echo packets on the network. racadm ping Input —The IP address of the remote endpoint to ping. Example To ping ip address 192.168.0.1 racadm ping 192.168.0.1 ping6 Description Synopsis Sends ICMP echo packets on the network.
Before or after performing racresetcfg in the member chassis, go to the lead chassis and remove the member chassis from the MCM group. Synopsis Input racadm racresetcfg ● -f—Resets all management module configurations to the default configuration and preserves the user-configured and network settings. Running the racresetcfg command results in the following: ● Clears Management Module Configuration and resets to Initial settings. ● Rediscovers iDRAC.
setniccfg Description Synopsis Modifies network configuration properties. racadm setniccfg [-m ] -d racadm setniccfg [-m ] -d [-6] racadm setniccfg [-m ] -s racadm setniccfg [-m ] -s -6 racadm setniccfg [-m ] -v [vlan_id] Input ● -m—The option must be one of the following values: ○ switch-, where n = 1-6 ○ chassis—The default state if -m is not specified.
Synopsis Input Example racadm swinventory racadm swinventory To view the software inventory: racadm swinventory traceroute Description Synopsis Prints the route packets trace to the network host. racadm traceroute Input —The IPv4 address or hostname of the remote endpoint to trace. Example To execute a trace route for IP address 192.168.0.2: racadm traceroute 192.168.0.2 traceroute6 Description Synopsis Prints the route packets trace to the network host.
3 OpenManage Enterprise Modular property database group and object descriptions You can configure a setting that does not have a hash sign (#) prefixed in the output. To modify a configurable object, use the —o option. Topics: • • • • cfgLanNetworking cfgStorageModule cfgUserAdmin cfgRacTuning cfgLanNetworking This group contains parameters to configure OME-Modular NIC for IPv4. One instance of the group is allowed.
3. racadm config -g cfglannetworking -o cfgDNSServer1 100.69.112.5 For Alternate DNS Server name use cfgDNSServer2 4. racadm config -g cfglannetworking -o cfgDNSRegisterRac 1 If step 1 is applied, to return to the original state. NOTE: You can modify the cfgDNSServer1 and cfgDNSServer2 only when cfgDNSServersFromDHCP is 0. Else, the static DNS server settings are ignored. NOTE: Disable Use DHCP for DNS Domain Name to configure the DNS Domain Name.
● 0 — False Default 0 NOTE: For IPv6, only the DHCPv6 address or static address is registered. Example: racadm getconfig -g cfgLanNetworking cfgDNSServersFromDHCP=1 cfgDNSServer1=192.168.0.5 cfgDNSServer2=192.168.0.6 cfgDNSRacName=cmc-frankly cfgDNSDomainName=fwad.lab cfgDNSDomainNameFromDHCP=1 cfgDNSRegisterRac=1 cfgDNSRacName (Read or Write) Description Displays the management module name, which is Service Tag by default. This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE).
The management module can obtain its DNS domain name from either a DHCP or DHCPv6 server, if the following properties are set to 1 (true): ● ● ● ● IPv4Enable NIC Enabled IPv6 Enabled Autoconfiguration Enabled The network administrator must ensure that these DHCP servers are configured to provide the same DNS domain name to the management module. Else, the domain name becomes unpredictable. cfgStorageModule Description This command is used only with the getconfig command.
cfgStorageModuleServiceTag Description Synopsis Input Displays the service tag. cfgStorageModuleServiceTag= cfgStorageModuleServiceTag= Example cfgStorageModuleServiceTag=MX0000 cfgStorageModuleAssetTag Description Synopsis Input Displays the asset tag. cfgStorageModuleAssetTag= cfgStorageModuleAssetTag Example cfgStorageModuleAssetTag=xxxxxx cfgConnectedSlots Description Synopsis Input Displays the connected slots.
cfgUserAdminPassword - Write Only Description The password for this user. User passwords are encrypted and cannot be seen or displayed after the property is written. Legal Values A ● ● ● ● Default ******** string of up to 20 ASCII characters. The following characters are supported in a password: Uppercase letters Lowercase letters Numbers—0-9 Special characters—/, -, _, .
Example racadm config -g cfgRacTuning -o cfgRacTuneMaxAuthRetries 5 The maximum number of authentication attempts that are allowed is nine. The default value is "3".
