..........................9 Supported RACADM Subcommands ............................11 Other Documents You May Need ........................11 Accessing Documents From Dell Support Site ..................................12 Contacting Dell 2 RACADM Subcommand Details..................13 ........13 Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands ............................
The RACADM command-line utility provides a scriptable interface that allows you to locally configure or remotely configure your CMC. The utility runs on the management station and the managed system. It is available on the Dell OpenManage Systems Management and Documentation DVD or at support.dell.com.
Supported RACADM Subcommands The following table provides the list of RACADM subcommands and their corresponding interface support. For more information about the RACADM subcommands including syntax and valid entries, see RACADM Subcommand Details. Subcommand Telnet/SSH/Serial Remote RACADM "?" and "? <subcommand>" help and help subcommand chassisaction chassislog...
Other Documents You May Need In addition to this guide, you can access the following guides available on the Dell Support website at www.dell.com/esmmanuals. To access the documents, click the appropriate product link. • The Chassis Management Controller User’s Guide provides information about configuring and using CMC to remotely manage and monitor your system and its shared resources through a network.
Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues: Go to dell.com/support.
RACADM Subcommand Details This section provides detailed description of the RACADM subcommands including the syntax and valid entries. Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands When using strings that contain special characters, use the following guidelines: Strings containing the following special characters must be quoted using single quotation marks or double quotation marks: •...
racadm ? and ? subcommand Description Displays all the subcommands you can use with the RACADM command and a one-line description about each subcommand. ? followed by <subcommand> displays the syntax for the specified command. To use this subcommand, you must have the CMC Login User privilege. You can also use the help and help <subcommand>...
getssninfo -- display session information getsvctag -- display service tag information getsysinfo -- display general CMC and system information gettracelog -- display the CMC diagnostic trace log getversion -- display version information for modules getarraycfg -- display's storage array properties ifconfig -- display network interface information krbkeytabupload -- upload an Kerberos Keytab to the CMC...
• <device name> — specifies the device name such as iDRAC, BIOS, NIC, LifecycleController, FC, system, or Storage. • <group> — specifies the group name supported by the corresponding device. • <object> — specifies the object for the entered group. •...
NOTE: If a server takes longer duration to turn off gracefully after the chassis power cycle is initiated, CMC stops functioning indicating that graceful shutdown of the server was unsuccessful. In this case, you must ungracefully turn off the system or try to gracefully turn off the system again.
To run this subcommand, you must have the Administrator permission NOTE: This subcommand ends all the sessions other than the current session. • Synopsis racadm closessn –i <session_ID> • racadm closessn -a • racadm closessn -u <username> • —i <session_ID> — The session ID of the session to close, which can be retrieved using RACADM Input getssninfo subcommand.
<filename> and configure iDRAC or CMC. The file must contain data in the format specified in the section Parsing Rules in the CMC User’s Guide available at www.dell.com/esmmanuals. NOTE: The -f option is not supported for the Serial or Telnet or SSH console.
• -o — The -o <objectName>, or object option, must be used with the -g option. This option specifies the object name that is written with the string • <value> — Value to set to configuration object. • -i — The -i <index>, or index option, is valid only for indexed groups and can be used to specify a unique group (used with -g and -o).
-b — Connects to the switch or console using the binary mode. -b is an optional; a server or a switch must be Input present. NOTE: If you use the -b option, reset the CMC to end the connect operation. -m <module>...
SD card used to activate the feature. Dell Feature Cards may contain more than a feature. After any feature included on a Dell Feature Card is activated on a chassis, any other features that may be included on that Dell Feature Card cannot be activated on a different chassis.
NOTE: To deactivate FlexAddress features, the chassis must be turned off. • Synopsis racadm feature -s • racadm feature -d -c <featurename> • racadm feature -r -c ExtendedStorage Input –Displays the status of active features. –Deactivates feature specified in -c option. NOTE: When the FlexAddress and FlexAddressPlus feature are active, deactivating one of them results in deactivation of the other feature also.
• The feature card inserted is valid and contains the following feature(s) FlexAddress: The feature card is not bound to any chassis Action: The feature card can be moved to another chassis, or can be reactivated on the current chassis. To reactivate on the current chassis, enter racadm racreset until the CMC module with the feature card installed becomes active.
Page 25
• Upload firmware image from TFTP server and start firmware update. For SSH or Telnet or Serial: Synopsis racadm fwupdate -g -u -a <tftp_server_ip_address_or_FQDN> -d <path> [-m <module>] racadm fwupdate -f <ftp_server_ip_address_or_FQDN> <username> <password> -d <path> [-m <module>] racadm fwupdate -u -m iominf-<n> racadm fwupdate -s [-m <module>] racadm fwupdate -c [-m <module>] For Remote RACADM:...
Page 26
– kvm – server-<n> — where n=1–16 – server-<nx> — where n=1–8; x = a, b, c, d (lower case) – server-<g> <generation> — where generation = iDRAC or iDRAC6 only. – iominf-<n> — where n = 1–6 NOTE: Multiple modules can be specified except iominf-<n>, for example, –m <module 1> –m <module 2>...
NOTE: Firmware update from local RACADM (using -p -u -d options) is not supported on linux OS. NOTE: These commands specifically apply to an active-CMC update. Signed CMC Firmware Image: • To get the firmware update status: racadm fwupdate –s –m cmc-active Invalid firmware: The uploaded firmware image does not contain a verification signature.
Page 28
• cmc-<n> — where n=1, 2 • fan-<n> — where n=1–9 • ps-<n> — where n=1–6 • chassis • • NOTE: A few of the informational messages are applicable for more than one module. To avoid repetition of the same message for different modules, only one such informational message is displayed for the default command racadm getactiveerrors.
Severity = Critical Message = The power input for power supply 1 is lost. Module ID = ps-3 Severity = Critical Message = The power input for power supply 3 is lost. Module ID = cmc-1 Severity = NonCritical Message = A firmware or software incompatibilty detected between system BIOS in slot 4 and CMC.
getchassisname Description Displays the name of the chassis. To run this subcommand, you must have the CMC Login User privilege. racadm getchassisname Synopsis Input racadm getchassisname Example CMC-JGB6B2S getconfig Displays CMC configuration properties. Description Synopsis • racadm getconfig -g <group> [-m <module>] •...
If errors are not encountered, this subcommand displays the content of the specified configuration. • Displays the configuration properties (objects) that are contained in the group cfgLanNetworking. Example racadm getconfig -g cfgLanNetworking • Saves all group configuration objects from CMC to myrac.cfg. racadm getconfig -f myrac.cfg •...
server-5 Not Present None None server-6 Not Present None None server-7 Not Present None None server-8 Present LPe1105-M4 None server-9 Extension(1) None None server-10 Not Present None None server-11 Not Present None None server-12 Not Present None None server-13 Not Present None None server-14...
Page 34
Enabled Not Present Enabled Not Present Enabled Present Enabled Not Present Enabled Not Present Enabled Not Present Enabled Not Present Enabled Extension(2) Enabled Not Present Enabled Not Present Enabled Extension(5) Enabled Not Present Enabled Not Present Enabled Not Present <Fabric> <Type>...
NOTE: 10 GbE KR/3— The value 3 indicates that the fabric is iSCSI/FCoE-FIP. getfanreqinfo Description Displays fan speed request for servers and switches in percent (%). To run this subcommand, you must have the CMC Login User privilege. racadm getfanreqinfo Synopsis Input Output...
getled Description Displays the LED settings on a module: blinking, not blinking, or unknown (for empty slots). To run this subcommand, you must have the Login User privilege. racadm getled -m <module> Synopsis —m <module> can be one of the following: Input •...
Page 39
• racadm getmacaddress -c Flexaddress • racadm getmacaddress -c Factory • racadm getmacaddress -c all Input • -m <module> — Specifies the module whose MAC address you want to view. <module> may be one of the following: server-<n>, where n=1–16 server-<nx>, where n=1–8;...
Page 40
<Name> <Presence> <BMC MAC Address> <NIC1 MAC <NIC2 MAC Address> Address> Present F0:4D:A2:77:71:72 racadm getmacaddress -m switch-1 <Name> <Presence> <BMC MAC Address> <NIC1 MAC <NIC2 MAC Address> Address> Switch-1 Present Not Installed Not Installed 00:00:00:00:00:00 Display MAC for server-1. racadm getmacaddress -m server-1 <Name>...
Page 41
<Name> <Type> <Presence> <BMC MAC <NIC1 MAC <NIC2 MAC Address> Address> Address> Present 00:1E:4F:1F: 3C:58 Server-1-A Gigabit Present 00:1E:4F: 00:1E:4F: 00:1E:4F: Ethernet 2A:AF:7B 2A:D3:97 2A:D3:99 iSCSI Present 00:1E:4F: 00:1E:4F: 2A:D3:98 2A:D3:9A Server-1-B Gigabit Present Not Installed Not Installed Ethernet iSCSI Present Not Installed Not Installed...
Server-7-A 10 GbE KR Present 00:90:FA: Disabled Factory 51:34:F4 10 GbE KR/3 Present 00:90:FA: Unknown Factory 51:34:F5 Switch-6 10 GbE KR Present Factory 00:00:00:00:00: getmodinfo Description Displays configuration and status information for all modules or a specified module (server, switch, CMC, fan unit, power supply unit (PSU), KVM, or I2C cable) in the chassis.
IO-Cable Present noble01 FPC-Cable Present noble01 NOTE: A power state of "Primary" denotes Active CMC. getniccfg Displays the current NIC settings. Description racadm getniccfg [-m <module>] Synopsis –m <module> must be one of the following values: Input • chassis : Default state if -m is not specified. •...
• Display iDRAC network settings in server slot 1 racadm getniccfg -m server-1 getpbinfo Description Displays power budget status information. To run this subcommand, you must have the CMC Login User privilege. racadm getpbinfo Synopsis Input Example Displays power budget status information racadm getpbinfo [Power Budget Status] System Input Power...
Available Power in EPP Pool = 0 W (0 BTU/h) Used Power in EPP Pool = 0 W (0 BTU/h) EPP Percent - Available = 0.0 [Chassis Power Supply Status Table] <Name> <Model> <Power State> <Input <Input Volts> <Output Rated Current>...
Page 48
To run this subcommand, you must have the CMC Login User privilege. racadm getpminfo Synopsis Input Example: Displays power managemnt status information: racadm getpminfo [Real-Time Power Statistics] System Input Power = 1661 W (5667 BTU/h) Peak System Power = 1916 W (6537 BTU/h) Peak System Power Start Time = 09:19:27 11/26/2014 Peak System Power Timestamp...
Input Power Allocated to Chassis = 1402 W Infrastructure Total Input Power Available for Allocation = 13408 W Standby Input Power Capacity = 0 W getraclog The getraclog command displays CMC log entries. Description • Synopsis racadm getraclog [-i] • racadm getraclog [-s <start>] [-c <count>] [--more] NOTE: If options are not provided, the entire log is displayed.
NOTE: If no arguments are specified, the entire log is displayed. • —i — Displays the number of entries in the SEL. Input • -s — Displays the starting record number. • -c — Specifies the number of records to display. •...
PS-3 Online PS-4 Slot Empty PS-5 Failed PS-6 Slot Empty <senType> <Num> <sensorName> <status> Cable IO-Cable Cable FPC-Cable getslotname Displays the name and host name (if available) of all 16 slots, or of a specified slot (the slot number is indicated) Description in the chassis.
• Check if Display Host names is active (1 = Active). racadm getslotname -h getssninfo Displays a list of users that are connected to CMC. The following information is displayed: Description • Session ID • Username • IP address (if applicable) •...
Current IPv6 Gateway = :: Current IPv6 DNS Server 1 = :: Current IPv6 DNS Server 2 = :: DNS Servers from DHCPv6 Chassis Information: System Model = PowerEdge M1000e System AssetTag = 12345678901234567890123456781234456771234567890asvcdefrtghyhytg Service Tag = JGB6B2S Chassis Name = CMC-JGB6B2S...
krbkeytabupload Description Uploads a Kerberos keytab file to CMC. To run this subcommand, you must have the Configure Chassis Administrator privilege. NOTE: This subcommand is only supported on the remote interface(s). racadm krbkeytabupload [-f <filename>] Synopsis <filename> is the name of the file including the path. Input -f —...
127.0.0.1:199 127.0.0.1:52175 ESTABLISHED 192.168.0.32 192.168.0.31 ESTABLISHED 127.0.0.1:52174 127.0.0.1:199 ESTABLISHED 127.0.0.1:52887 127.0.0.1:8195 ESTABLISHED ping Description Verifies if the destination IP address is reachable from CMC with the current routing-table contents. A destination IP address is required. Based on the current routing-table contents, an ICMP echo packet is sent to the destination IP address.
Page 60
= 0.0.0.0 DNS Servers from DHCP Register DNS CMC Name DNS CMC Name = cmc-servicetag Current DNS Domain Chassis Information: System Model = PowerEdgeM1000eControlPanel System AssetTag = 00000 Service Tag Chassis Name = Dell Rack System Chassis Location = [UNDEFINED]...
racadm racreset Output RAC reset operation initiated successfully. It may take up to a minute for the RAC to come online again. • To reset CMC. Example racadm racreset • To reset server 1 racadm racreset -m server-1 • To reset servers 1 and 3 racadm racreset -m server-1 -m server-3 racresetcfg Deletes your current CMC configuration and resets CMC to the factory default settings.
The configuration has initiated restoration to factory defaults. • Reset blade 8 configuration from CMC. racadm racresetcfg -m server-8 The RAC configuration has initiated restoration to factory defaults. Wait up to a minute for this process to complete before accessing the RAC again. remoteimage Description Connects, disconnects, or deploys a media file on a remote server.
• Deploy a remote image on iDRAC CIFS share for all the servers. Example racadm remoteimage -c -a -l '//192.168.0/dev/floppy.img' -u admin -p xxx • Deploy a remote image on iDRAC NFS share for all the servers. racadm remoteimage -c -a -l '192.168.0:/dev/floppy.img' -u admin -p xxx serveraction Description Enables you to perform power management operations on the blade system.
• Turn off the server 16 from CMC, when the power is already turned off on that server by using the following command: racadm serveraction -m server-16 powerdown Server is already powered OFF. • Power action on all servers by using the following command: racadm serveraction -a powerup setarraycfg Description...
• Set member name, member IP, member netmask, member gateway with existing group name, group IP, group password selecting fabric B on server-1. racadm setarraycfg -m server-1 -n cmc-col 192.168.1.233 255.255.255.0 192.168.1.0 -e 1 -g cmc-array-grp 192.168.1.10 <password> -f B •...
NOTE: The server must be turned off to change the slot state. All servers must be turned off to change the fabric state. The MAC/WWN addresses must be managed locally (not by an external console) to run this command. • Synopsis racadm setflexaddr -i <slotNum>...
• racadm setled -m server-9 -1 1 ERROR: Server in slot 9 is an extension of the server in slot 1. NOTE: The setled command generates an error when run on the extension slot of a multi-slot server. setniccfg Description Sets the iDRAC or CMC IP address for static and DHCP modes.
• Configuration of Speed= 100 Mbps and duplex= full duplex. Example racadm setniccfg -k 100 full • Configuration of Speed and Duplex to Autonegotiate. racadm setniccfg -k • Configuration of VLAN id and priority of a slot or all blades in a sleeve. racadm setniccfg -i 5 -v 1000 •...
The OMSA server agent must be present and running on the server to use the Display Hostname feature. If the agent is not running, the setting is ignored. For more information, see the Dell OpenManage Server Administrator User's Guide at support.dell.com/manuals.
<string> — Indicates a maximum of 64 nonextended ASCII chassis name or location. Input • -c — Sets the chassis name or location. • Example racadm setsysinfo -c chassisname "Dell Rack System" The chassis name was set successfully • racadm setsysinfo -c chassislocation chassislocation2 Sets Chassis location. sshpkauth Description Enables you to upload and manage up to 4 different SSH public keys for each user.
Example • Upload an invalid key to iDRAC User 2 in the first key space using a string. $ racadm sshpkauth -i 2 -k 1 -t "This is invalid key Text" ERROR: Key text appears to be corrupt • Upload a valid key to iDRAC User 2 in the first key space using a file. $ racadm sshpkauth -i 2 -k 1 -f pkkey.key Key file successfully uploaded.
To run this subcommand, you must have the Server Control privilege. NOTE: This subcommand is only supported on the remote interfaces. racadm sslcertupload -f <filename> -t <type> Synopsis • -t <type> — Specifies the type of certificate to upload. The type of certificate must be: Input –...
State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU) Remote Access Group Common Name (CN) CMC Default certificate Issuer Information: Country Code (CC) State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU)
To run this subcommand, you must have the Configure chassis administrator privilege. • Synopsis racadm sslcsrgen -g • racadm sslcsrgen [-g] [-f <filename>] • racadm sslcsrgen -s • -g — Generates a new CSR. Input • -s — Returns the status of a CSR generation process (generation in progress, active, or none). •...
The specified index in the cfgEmailAlert group must be enabled and configured properly. For more information, see the Integrated Dell Remote Access Controller (iDRAC8) and iDRAC7 RACADM Command Line Interface Reference Guide available at dell.com/support/manuals. racadm testemail -i <index> Synopsis Input -i <index>...
• To test LDAP. racadm testfeature -f LDAP -u joe -p dell123 -d 0xf2 testtrap Description Tests the RAC’s SNMP trap alerting feature by sending a test trap from CMC to a specified destination trap listener on the network. To run this subcommand, you must have the Test Alert permission. NOTE: Before you run the testtrap subcommand, make sure that the specified index in the cfgAlerting group is configured properly.
CMC Property Database Group and Object Descriptions CMC property database contains the configuration information. Associated object is organizing data, and object group is organizing object. The IDs for the groups and objects that the property database supports are listed in this section. To configure CMC, use the group and object IDs with the RACADM subcommands.
Subcommand cfgRacTuning cfgServerInfo cfgActiveDirectory cfgStandardSchema cfgLDAP cfgLdapRoleGroup cfgLocation cfgChassisPower cfgThermal cfgKVMInfo cfgAlerting cfgLcdInfo cfgIPv6LanNetworking cfgCurrentLanNetworking cfgCurrentIPv6LanNetworking cfgNetTuning cfgRacSecurity idRacInfo This group contains display parameters to provide information about the specifics of CMC being queried. One instance of the group is allowed. Use this object with the getconfig subcommand. To use this object, you must have the CMC Login User privilege.
A text description of the RAC type. Description A string of up to 255 ASCII characters. Legal Values This system component provides a complete set of remote management functions for Dell PowerEdge Default servers. idRacVersionInfo (Read Only) String containing the current product firmware version Description A string of up to 63 ASCII characters.
# idRacBuildInfo=200708301525 # idRacName=CMC-1 racadm getconfig -g idRacInfo # idRacType=16 # idRacProductInfo=Integrated Dell Remote Access Controller # idRacDescriptionInfo=This system component provides a complete set of remote management functions for Dell PowerEdge Servers # idRacVersionInfo=1.06.06 # idRacBuildInfo=15 # idRacName=idrac-GSRS3V1 cfgLanNetworking This group contains parameters to configure CMC NIC for IPv4.
Page 82
cfgNicVLanID (Read or Write) Specifies the VLAN ID for the network VLAN configuration. This property is only valid if cfgNicVLanEnable Description is set to 1(enabled). 1–4000 and 4021–4094 Legal Values Default racadm config -g cfgLanNetworking -o cfgNicVlanID Example cfgNicVLanPriority (Read or Write) Specifies the VLAN Priority for the network VLAN configuration.
Page 83
• cfgNicUseDhcp • cfgIPv6Enable • cfgIPv6AutoConfig • cfgDNSDomainNameFromDHCP • cfgDNSDomainName (Read or Write) The network administrator must make sure that these DHCP servers are configured to provide the same DNS domain name to the CMC, otherwise the domain name becomes unpredictable. cfgDNSServersFromDHCP (Read or Write) Specifies if the DNS server IPv4 addresses must be assigned from the DHCP server on the network.
Page 84
NOTE: For IPv6, only the DHCPv6 address or static address is registered. Example: racadm getconfig -g cfgLanNetworking cfgNicEnable=1 cfgNicIPv4Enable=1 cfgNicIpAddress=192.168.22.101 cfgNicNetmask=255.255.255.0 cfgNicGateway=192.168.22.101 cfgNicUseDhcp=1 # cfgNicMacAddress=00:00:00:00:00:01 cfgNicVLanEnable=0 cfgNicVLanID=1 cfgNicVLanPriority=0 cfgDNSServersFromDHCP=1 cfgDNSServer1=192.168.0.5 cfgDNSServer2=192.168.0.6 cfgDNSRacName=cmc-frankly cfgDNSDomainName=fwad.lab cfgDNSDomainNameFromDHCP=1 cfgDNSRegisterRac=1 cfgDNSServer2 (Read or Write) Retrieves the IPv4 address for DNS server 2. This parameter is only valid if cfgDNSServersFromDHCP is set Description to 0 (FALSE).
Page 85
cfgNicIpAddress (Read or Write) Specifies the static IPv4 address. Description NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0(FALSE). String representing a valid IPv4 address. For example: 192.168.0.20. Legal Values • Default 192.168.0.120 cfgNicNetmask (Read or Write) The subnet mask used for IP address.
The current MAC address of NIC. For example, 00:12:67:52:51:A3. Default cfgRemoteHosts This group provides properties that allow configuration of the SMTP server for email alerts. This group enables/disables and configures firmware updates, NTP, remote syslogging and SMTP email alerting. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege.
Page 87
cfgRhostsNtpEnable (Read or Write) Description Enables or disables the use of the Network Time Protocol (NTP) for date and time synchronization. • 1 — True Legal Values • 0 — False Default cfgRhostsNtpServer1 (Read or Write) Description Specifies the first of three possible NTP servers. A string representing a valid NTP server.
Page 88
cfgRhostsSyslogPort (Read or Write) Description Remote syslog port number to use for writing the RAC and SEL logs to a remote syslog server. This setting takes effect only if the cfgRhostsSyslogEnable parameter is set to 1(enabled). 10–65535 Legal Values NOTE: The following port numbers are reserved and cannot be used: 21, 68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
cfgRhostsSyslogPowerLoggingInterval (Read or Write) Description Specifies the power consumption collection/logging interval. 1–1440 (minutes) Legal Values Default Example racadm getconfig -g cfgRemoteHosts [-m server-<n>] cfgRhostsFwUpdateTftpEnable=1 cfgRhostsFwUpdateIpAddr=0.0.0.0 cfgRhostsFwUpdatePath= cfgRhostsSmtpServerIpAddr=localhost.localdomain cfgRhostsNtpEnable=0 cfgRhostsNtpServer1= cfgRhostsNtpServer2= cfgRhostsNtpServer3= cfgRhostsNtpMaxDist=16 cfgRhostsSyslogEnable=0 cfgRhostsSyslogPort=514 cfgRhostsSyslogServer1= cfgRhostsSyslogServer2= cfgRhostsSyslogServer3=cfgRhostsSyslogPowerLoggingEnabled=1 cfgRhostsSyslogPowerLoggingInterval=5 cfgUserAdmin This group provides configuration information about the users allowed to access CMC through the available remote interfaces. Up to 16 instances of the user group are allowed.
Page 90
cfgUserAdminPrivilege (Read or Write) This property specifies the role-based authority privileges allowed for the user. The value is represented as a bit Description mask that allows for any combination of privilege values. The table below describes the user privilege bit values that can be combined to create bit masks.
Page 91
User 0x0000004 Configuration Administrator Clear Logs 0x0000008 Administrator Chassis Control 0x0000010 Administrator Super User 0x0000020 Server 0x0000040 Administrator Test Alert User 0x0000080 Debug Command 0x0000100 Administrator Fabric A 0x0000200 Administrator Fabric B 0x0000400 Administrator Fabric C 0x0000800 Administrator Examples The following table provides sample privilege bit masks for users with one or more privileges. User Privileges Privilege Bit Mask The user is not...
cfgUserAdminUserName (Read or Write) The name of the user for this index. Writing a string of double quotation mark (" ") disables the user. The string Description cannot contain / (forward slash), \ (backward slash), . (period), @ (at symbol), quotation marks, ; (semicolon), or ‘...
Example racadm getconfig -g cfgEmailAlert -i 2 # cfgEmailAlertIndex=1 cfgEmailAlertEnable=1 cfgEmailAlertAddress=kfulton@dell.com cfgEmailAlertName=Kevin Fulton cfgSessionManagement This group contains parameters to configure the number of sessions that can connect to iDRAC or CMC. One instance of the group is allowed. Displays current settings for and configures the idle timeout properties for web server, Telnet, SSH and RACADM sessions.
Example racadm getconfig -g cfgSessionManagement cfgSsnMgtWebserverTimeout=0 cfgSsnMgtTelnetIdleTimeout=0 cfgSsnMgtSshIdleTimeout=1800 cfgSsnMgtRacadmTimeout=0 cfgSsnMgtWebserverTimeout (Read or Write) Defines the web server time-out. This property sets the amount of time (in seconds) that a connection is Description allowed to remain idle (there is no user input). The session is canceled if the time limit exceeds this property. Changes to this setting do not affect the current session.
Page 95
The following sections provide information about the objects in the cfgSerial group. cfgSerialBaudRate (Read or Write) Sets the baud rate on the serial port. Description 2400, 4800, 9600, 19200, 28800, 38400, 57600,115200 Legal Values 115200 Default cfgSerialConsoleEnable (Read or Write) Enables or disables the serial console interface.
Page 96
cfgSerialConsoleNoAuth (Read or Write) Enables or disables the serial console login authentication. Description • 0 — (enables serial login authentication) Legal Values • 1 — (disables serial login authentication) Default cfgSerialConsoleCommand (Read or Write) Specifies a serial command that is executed after a user logs in to the serial console interface. Description A string representing a valid serial command.
This group contains parameters to configure the SNMP agent and trap capabilities of CMC. One instance of the group is allowed. The CMC SNMP agent supports the standard RFC1213 mib-2 and the Dell enterprise-specific the MIB. Use this object with the config or getconfig subcommands.
cfgTraps This group displays information for and configures delivery of SNMP traps for a specific user. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure a setting that does not have the hash sign (#) prefixed in the output. To modify a configurable object, use the —o option.
cfgRacTuning This group is used to configure various configuration properties, such as valid ports and security port restrictions. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure a setting that does not have the hash sign (#) prefixed in the output.
Page 100
cfgRacTuneHttpPort (Read or Write) To use HTTP network communication, specify the port number. Description 10–65535 Legal Values NOTE: The following port numbers are reserved and cannot be used: 21, 68, 69, 111, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, and 60106. Default cfgRacTuneHttpsPort (Read or Write) To use HTTPS network communication, specify the port number.
Page 101
• cfgRacTuneIpRanbeMask bit-wise and with cfgRacTuneIpRangeAddr An IPv4 address formatted string, for example, 255.255.255.0. Legal Values 255.255.255.0 Default cfgRacTuneIpBlkEnable (Read or Write) Enables or disables the IPv4 address blocking feature. Description • 1 (TRUE) Legal Values • 0 (FALSE) Default cfgRacTuneIpBlkFailCount (Read or Write) The maximum number of logins that is not successful, to occur within the window Description...
Page 102
cfgRacTuneUserBlkEnable (Read or Write) Blocks the login for maximum of 5 minutes after 5 unsuccessful login attempts. The login using any interface Description such as WSMAN or GUI is blocked after 5 unsuccessful attempts NOTE: This is applicable only to configure the user privilege. •...
cfgRacTuneSshPort=22 cfgRacTuneIpRangeEnable=0 cfgRacTuneIpRangeAddr=192.168.1.1 cfgRacTuneIpRangeMask=255.255.255.0 cfgRacTuneIpBlkEnable=0 cfgRacTuneIpBlkFailCount=5 cfgRacTuneIpBlkFailWindow=60 cfgRacTuneIpBlkPenaltyTime=300 # cfgRacTuneTimezoneOffset=-18000 # cfgRacTuneDaylightOffset=3600 cfgRacTuneTimezoneOffset (Read Only) This object property is read only. Specifies the difference in number of seconds, from the UTC/GMT. This value Description is negative if the current time zone is west of Greenwich. None Legal Values Default...
Page 104
The following sections provide information about the objects in the cfgServerInfo. cfgServerInfoIndex (Read Only) Description Displays the index name of the server. None Legal Values None Default cfgServerSlotNumber (Read Only) Description Specifies the location of the specified server (1–16) in the chassis. Specify '-i nx' for HiFi blade information, where index-1 is a multi server sleeve.
Page 105
cfgServerBmcMacAddress (Read Only) Description Displays the BMC MAC address of the specified server. None Legal Values None Default cfgServerNic1MacAddress (Read Only) Description Displays the MAC address of the server NIC 1. None Legal Values None Default cfgServerNic2MacAddress (Read Only) Description Displays the MAC address of the server NIC 2.
Page 106
cfgServerPowerBudgetAllocation (Read Only) Description Displays the current power allocation for the server. None Legal Values None Default cfgServerDNSRegisterIMC (Read or Write) Description Enables or disables DNS name registration for iDRAC or IMC . • 1 — Enable Legal Values • 0 —...
Page 107
• • RFS (Remote File Share) No-Override Default cfgServerBootOnce (Read or Write) Description Enables or disables the server start once feature. This object is Write only. • 1 — True Legal Values • 0 — False Default cfgServerPowerConsumption (Read Only) Description Displays the current power consumption for a server.
# cfgServerRootPassword=******** (Write-Only) cfgServerFirstBootDevice=0 cfgServerBootOnce=1 # cfgServerPowerConsumption=84 cfgActiveDirectory This group contains parameters to configure CMC Active Directory feature. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure a setting that does not have the hash sign (#) prefixed in the output.
Page 109
cfgADSCLEnable (Read or Write) Enables or disables Smart Card login on CMC. Description • 1 (Enable) Legal Values • 0 (Disable) Default cfgADSSOEnable (Read or Write) Enables or disables Active Directory single sign-on authentication on CMC. Description • 1 (TRUE) Legal Values •...
• 0 (disabled) Default cfgADGlobalCatalog (Read or Write) To obtain user names, specify the Global Catalog server from which you want the CMC. It must be used with Description cfgADSpecifyServerEnable. Valid IP address or fully qualified domain name (FQDN) Legal Values None Default Example...
Page 111
If this property is disabled, local CMC authentication is used for user logins. NOTE: Enabling this option turns off cfgADEnable. • 1 — Enable Legal Values • 0 — Disable Default cfgLDAPServer (Read or Write) Configures the address of the LDAP Server. IPv4 and IPv6 are supported. Description NOTE: You can specify multiple servers by separating each server with a comma.
Page 112
cfgLDAPGroupAttribute (Read or Write) Specifies which LDAP attribute is used to check for group membership. It must be an attribute of the group Description class. If not specified then the member and unique member attributes are used. String maximum length = 254 Legal Values Null Default...
cfgLDAPCertValidationEnable (Read or Write) Controls certificate validation during SSL handshake. Description • 1 (TRUE) — Uses the CA certificate to validate the LDAP server certificate during SSL handshake. Legal Values • 0 (FALSE) —Skips the certificate validation step of SSL handshake. Default cfgLDAPNetworkTimeout (Read or Write) Description...
cfgLDAPRoleGroup This group configures Generic LDAP Role group descriptions and defines the CMC privileges that LDAP-authenticated users are granted. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure a setting that does not have the hash sign (#) prefixed in the output.
cfgStandardSchema This group contains parameters to configure the Active Directory standard schema settings. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege. NOTE: You can configure a setting that does not have hash sign (#) prefixed in the output. To modify a configurable object, use the —o option.
cfgLocationDataCenter (Read or Write) Indicates data center name. Description String of up to 128 ASCII characters Legal Values Default cfgLocationAisle (Read or Write) Indicates aisle where server is located. Description String of up to 128 ASCII characters Legal Values Default cfgLocationRack (Read or Write) Indicates rack where server is located.
Page 117
The following sections provide information about the objects in the cfgChassisPower group. cfgChassisServerBasedPowerMgmtMode (Read or Write) Manages the applicable functions by the Power Measure, Mitigate, and Manage Console (PM3). Description • 1 — Enabled Legal Values • 0 — Disabled Default 0 —...
cfgChassisMinPower (Read Only) Since the user has cleared last value, the system power consumption (in watts) is maximum. Description None Legal Values None Default cfgChassisMinPowerTimestamp (Read Only) The timestamp recorded when the minimum system power occurred. Description None Legal Values None Default cfgChassisPowerStatus (Read Only)
cfgChassisDefaultPowerCapLowerBound (Read Only) Displays the default power cap lower bound value. Description None Legal Values 2715 W Default cfgChassisDefaultPowerCapUpperBound (Read Only) Displays the default power cap upper bound value. Description None Legal Values 16685 W Default cfgChassisDefaultPowerCapUpperBoundBTU (Read or Write) Displays the default power cap upper bound value using British Thermal Unit (BTU).
Page 120
43221 BTU/hr Default cfgChassisPowerCapFBTU (Read or Write) Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis. Use Description cfgChassisCapFBTU when power consumption changes regardless of whether server throttling is required. The command generates an error if the value for this setting is lower than the minimum power required for the chassis configuration.
cfgChassisDynamicPSUEngagementEnable (Read or Write) Enables or disables dynamic engagement. Description • 0 — Disabled Legal Values • 1 — Enabled Default cfgChassisAllow110VACOperation (Read or Write) Description Enables or disables normal chassis power allocations when any PSU is connected to 110V AC service. If disabled and 110V power supplies are detected, all subsequent server power allocation requests are denied.
Page 122
power, both for redundancy, as well as full performance, then some servers may not grant sufficient power for full performance. In order to maintain redundancy, It may not be powered on. Legal Values • 0 — Disabled • 1 — Enabled Default cfgChassisInMaxPowerCapacity (Read Only) Indicates the total chassis power budget (in watts) available for chassis operation.
Page 123
cfgChassisStandbyInPowerCapacity (Read Only) Indicates the amount of power (in watts) available for powering up any hardware modules that are either added Description to the chassis or powered up (if they are already present in the chassis). None Legal Values None Default cfgChassisPowerClear (Write Only) Resets cfgChassisMinPower and cfgChassisMaxPowerCapacity, when set to 1.
(Read or Write) Enables or disables the Dell CMC Console access on the iKVM. Description • 1 (Enable) Legal Values • 0 (Disable) None Default cfgKVMFrontPanelEnable (Read or Write) Enables or disables front panel access on the iKVM. Description •...
cfgAlertingEnable (Read or Write) Enables or disables event traps on the CMC. Description • 1 (true) Legal Values • 0 (false) None Default cfgAlertingFilterMask (Read or Write) Sets the event filter. Description Hex values 0x0 — 0x1fffffff Legal Values 0x17ff8db Default cfgAlertingSourceEmailName (Read Only) Specifies the email address used to send email notifications when an event occurs.
Page 127
cfgIPv6Address (Read or Write) Assigns a static IPv6 address to the CMC. This property is used only if cfgIPv6AutoConfig is set to 0 Description (false). A string representing a valid IPv6 address. For example, 2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF Legal Values “ :: “ Default cfgIPv6Gateway (Read or Write) CMC gateway IPv6 address.
Page 128
NOTE: This property is used only if cfgIPv6AutoConfig is set to 1(true). 1 (TRUE) Legal Values 0 (FALSE) Default cfgIPv6DNSServer1 (Read or Write) Specifies the IPv6 DNS server address. Description NOTE: This property is used only if cfgIPv6DNSServersFromDHCP6 is set to 0 (false). A string representing a valid IPv6 entry.
cfgCurrentLanNetworking (Read Only) This group displays the current CMC NIC properties. Use this object with the getconfig subcommand. To use this object property, you must have the CMC Login User privilege. Synopsis racadm getconfig -g cfgCurrentLanNetworking cfgNicCurrentIpAddress (Read Only) Displays the static IP address to the CMC. Description A Valid IPv4 address Legal Values...
Page 130
cfgNicCurrentVlanEnable (Read Only) Indicates whether the VLAN is enabled. Description 0 — VLAN is disabled Legal Values 1 — VLAN is enabled None Default cfgNicCurrentVlanID (Read Only) Indicates the Current Virtual Lan ID Description Integer Legal Values None Default cfgNicCurrentVlanPriority (Read Only) Indicates the Current Virtual Lan Priority.
cfgNicCurrentIPv4Enabled (Read or Write) Indicates whether IPv4 is enabled on the CMC. If the current property value is set to 0 (false), the remote Description network interfaces to the CMC are not accessible over IPv4. • 0 — Disabled Legal Values •...
Page 132
cfgCurrentLinkLocalAddress (Read Only) Displays the current IPv6 link-local address of the CMC. Description None Legal Values None Default cfgCurrentIPv6Address (Read Only) Displays the current IPv6 addresses. This property displays up to 15 global IPv6 addresses, including stateful Description and stateless addresses. Legal Values Default cfgCurrentIPv6Gateway (Read Only)
Example racadm getconfig -g cfgCurrentIPv6LanNetworking # cfgCurrentIPv6Enabled=1 # cfgCurrentIPv6AutoConfigWasUsed=1 # cfgCurrentLinkLocalAddress=fe80::21e:4fff:fe1f:5371/64 # cfgCurrentIPv6Address1=2009:123::e48f:9dd8:6f51:a669/64 # cfgCurrentIPv6Address2=fd88:1::21e:4fff:fe1f:5371/64 # cfgCurrentIPv6Address3=fd88:2::21e:4fff:fe1f:5371/64 # cfgCurrentIPv6Gateway=fe80::21c:23ff:fe77:6215 # cfgCurrentIPv6DNSServersFromDHCP6=1 # cfgCurrentIPv6DNSServer1=2009:123::1 # cfgCurrentIPv6DNSServer2=:: cfgNetTuning This group enables users to configure the advanced network interface parameters. When configured, the updated settings may take up to a minute to become active.
• 1 (Full Duplex) Default cfgNetTuningNicMtu (Read or Write) Indicated the maximum size of units in bytes transmitted by NIC. Description 576–1500 Legal Values 1500 Default NOTE: IPv6 requires a minimum MTU of 1280. If IPv6 is enabled, and cfgNetTuningMtu is set to a lower value, the CMC uses an MTU of 1280.
Page 135
cfgRacSecCsrLocalityName (Read or Write) Specifies the CSR Locality (L). Description A string of up to 254 characters. Legal Values <blank> Default cfgRacSecCsrStateName (Read or Write) Specifies the CSR State Name (S). Description A string of up to 254 characters. Legal Values <blank>...