Dell EMC OpenManage Enterprise Modular Edition for PowerEdge MX7000 Chassis RACADM Command Line Reference Guide April 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 Updates for new features and enhancements Revision history 3
Contents Revision history..........................................................................................................................................................................3 Chapter 1: Introduction................................................................................................................. 6 New in this release.............................................................................................................................................................
cfgDNSRacName (Read or Write).......................................................................................................................... 30 cfgDNSDomainName (Read or Write)................................................................................................................... 30 cfgDNSDomainNameFromDHCP (Read or Write).............................................................................................. 30 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.
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. If the -u option is used, the -p option must be used, and the -i option is not allowed. -p Specifies the password that is used to authenticate the command transaction. If the -p option is used, the -i option is not allowed.
Table 3. List of documents Name of the document Brief introduction of the document OS10 Enterprise Edition User Guide This document provides information about the features of the OS10 switches and using commands in the IOM CLI to configure the switches. Dell EMC PowerEdge MX7000 Enclosure Installation and Service Manual This document provides information about installing and replacing components in the PowerEdge MX7000 enclosure.
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 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.
Available Power in EPP Pool Used Power in EPP Pool EPP Percent - Available = Not Applicable = Not Applicable = Not Applicable [Chassis Power Supply Status Table]
[Real-Time Energy Statistics] System Energy Consumption System Energy Consumption Start Time System Energy Consumption Timestamp = 204 kWh = Not Applicable = 05:47:05 08/20/2018 [System Power Status] 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 Alloc
FanSpeed N/A Temp Celsius PWR OK PWR Not OK PWR N/A PWR OK PWR Not OK PWR N/A ● N/A 9 1 -7 100 Fan-9 OK 14484 Chassis Inlet Temperature 47 rpm OK 27 1 PS-1 Online 2 PS-2 Input Lost 3 PS-3 Slot Empty 4 PS-4 Online 5 PS-5 Configuration Error 6 PS-6 Slot Empty racadm getsensorinfo -c Sensor Type: Fan 1 Fan-1 2 Fan-2 3 Fan-3 4 Fan-4 5 Fan-5 6 Fan-
● -6—Displays IPv6 settings ● -6 without -s option—Sets the static IPv6 address for the chassis ● -6 without -d option—Enables autoconfiguration of IPv6 for the chassis 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.
racresetcfg Description Restores the RAC configuration to factory defaults. 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.
● Reseat action on a single storage: racadm serveraction -m storage-2 -f reseat setniccfg Description Synopsis Modifies network configuration properties.
swinventory Description Synopsis Input Example Displays the list of the software objects installed in the chassis. 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.
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".