RACADM Command Options ........................14 Supported RACADM Subcommands ........................... 17 Other Documents You May Need .......................18 Accessing Documents From Dell Support Site 2 RACADM Subcommand Details....................19 ......19 Guidelines to Quote Strings Containing Special Characters When Using RACADM Commands ............................20 "?"and "?<subcommand>"...
Introduction This document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object definitions of CMC for PowerEdge VRTX. Supported RACADM Interfaces The RACADM command-line utility provides a scriptable interface that allows you to remotely configure your Remote Dell Access Controller (RAC).
Other Documents You May Need To access the documents from the Dell Support site. Along with this Reference Guide, you can access the following guides available at dell.com/support/manuals. VRTX CMC Online Help provides information about using the Web interface. To access the Online Help, click •...
To access the documents from Dell Support site: 1. Go to dell.com/support/manuals. 2. In the Tell us about your Dell system section, under No, select Choose from a list of all Dell products and click Continue. 3. In the Select your product type section, click Software and Security.
RACADM Subcommand Details This section provides detailed descriptions about 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: •...
For single quotation marks: • No character escaping is necessary. • A single quotation mark cannot be used even with a backslash escaped. NOTE: An empty string may be specified as either "" (using double quotation marks) or '' (using single quotation mark).
racadm getsysinfo [-d] [-c] [-A] [-4] [-6] ----------------------------------------------------------- Valid Options: -d : show CMC information -c : show chassis information -A : do not show headers or labels -4 : show CMC IPv4 information -6 : show CMC IPv6 information help and help <subcommand>...
Page 22
Input • -i — Displays the number of records present in the active log. You cannot use this option with any other option. • -c — The log type to filter the records. Provide multiple categories using a "," as the delimiter.
• Display 5 records starting from sequence number 20: racadm chassislog view -q 20 -n 5 • Display all records of events that have occurred between 2011-01-02 23:33:40 and 2011-01-03 00:32:15: racadm chassislog view -r "2011-01-02 23:33:40" -e "2011-01-03 00:32:15" •...
chassisaction Description Executes a power action on the chassis or a server. To use this subcommand, you must have the Chassis Control Administrator privilege. Synopsis racadm chassisaction [-m <module>] <action> Input module > — Module on which you want to •...
To use this subcommand, you must have the Administrator privilege. NOTE: This command is valid only in redundant CMC environments. For more information, see the "Understanding the Redundant CMC Environment" Dell Chassis System User Guide . section of the Synopsis racadm cmcchangeover Input...
-f — The -f < filename > and configure iDRAC. The file must contain data in the format specified in the < iDRAC User’s Guide available at support.dell.com/manuals. section Parsing Rules in the • -p— This option must be used with the -f option. It directs config to delete the password filename >...
connect Description Connects to the switch or server serial console. Synopsis • racadm connect [-b] <server-n> • racadm connect [-b] <switch-n> Input -b — Connects to the switch or console using the binary mode. This is an optional argument; a server or a switch must be present.
ipaddress subnet gateway > — Sets the IP address, subnet mask, and • -s < gateway for the specified server, separated by single spaces. – ipaddress — A string representing a valid IP address. For example, 192.168.0.20. – subnet — A string representing a valid subnet mask. For example, 255.255.255.0.
Page 29
NOTE: The general format of an alert descriptor: cmc.alert.category.[subcategory].[severity] where, category is mandatory, but subcategory and severity are optional. A severity cannot precede a subcategory. Valid category values are: • System • Config • Updates • Storage • Audit Valid severity values are: •...
• Display eventfilter configurations for a specific severity and subcategory. For example, a severity of warning in the subcategory licensing under audit category: racadm eventfilters get -c cmc.alert.audit.lic.warning • Clear all available alert settings: racadm eventfilters set -c cmc.alert.all -n none •...
Displays all active chassis features. The information displayed includes feature name, date activated, and the serial number of the SD card used to activate the feature. Dell Feature Cards may contain more than one feature. NOTE: To use this subcommand to deactivate FlexAddress or ExtendedStorage, you must have the Chassis Configuration Administrator privilege.
Output An example of output is given here. racadm featurecard -s Active CMC: The feature card inserted is valid, serial number = CN0H871T137401112222A00 The feature card contains the following feature(s): FlexAddress: bound FlexAddressPlus: bound ExtendedStorage: bound Standby CMC: The feature card contains the following feature(s): FlexAddress: not bound FlexAddressPlus: not bound...
Page 33
Input NOTE: Firmware update from local RACADM (using the -p, -u, or -d options) is not supported on Linux operating system. • -p — The -p option is used to update the firmware file from the client. The -u option must be used with the -p option.
• Upload the firmware image from the FTP server and start the firmware update. racadm fwupdate -f 192.168.0.100 fred password123 -d firmimg.cmc -m cmc-active • Start IOM infrastructure firmware update. racadm fwupdate -u -m iominf-1 • Update firmware on both the CMCs. racadm fwupdate -g -u -a 192.168.0.100 -d firmimg.cmc -m cmc-active -m cmc-standby The following table describes the firmware update methods supported for each interface.
Module ID = Chassis Severity = Critical Message = The control panel cable or interconnect is not connected or is improperly connected. ----------------------------------------------------------- -------------------- Module ID = PSU-3 Severity = Critical Message = Power supply 3 failed. ----------------------------------------------------------- -------------------- Module ID = PSU-4 Severity = Critical...
If errors are not encountered, this subcommand displays the contents of the specified configuration. Example • Displays all of the configuration properties (objects) that are contained in the group cfgLanNetworking. racadm getconfig -g cfgLanNetworking • Saves all group configuration objects from iDRAC to myrac.cfg.
Synopsis racadm getioinfo Example racadm getioinfo <IO> <Name> <Type> <Presence> <POST> <Power> <Role> switch-1 Dell Gigabit Present Master Ethernet Ethernet Passthroug getled Description Displays the LED settings on a module: blinking, not blinking, or unknown (for empty slots). To use this subcommand, you must have the Login User privilege.
Page 43
<module > can be one of the following values: – server-n, where n = 1 to 4 – switch-n, where n = 1 – CMC-n, where n = 1 or 2 – fan-n, where n = 1 to 6 – blower-n, where n = 1 to 4 –...
Page 45
• chassis : default state if -m is not specified • server-n : where n = 1 to 4 • switch-n : where n = 1 Example getniccfg NIC Enabled= 1 IPv4 Enabled = 1 DHCP Enabled = 1 Static IP Address = 192.168.0.120 Static Subnet Mask = 255.255.255.0 Static Gateway = 192.168.0.1 Current IP Address = 10.36.1.78...
To use this subcommand, you must have the CMC Login User privilege. Synopsis racadm getpbinfo Example racadm getpbinfo [Power Budget Status] System Input Power = 333 W Peak System Power = 403 W Peak System Power Timestamp = 15:38:01 06/14/2013 Minimum System Power = 269 W Minimum System Power Timestamp...
Page 48
• -c — Use this option to select a specific PCIe adapter or Virtual Adapter. • FQDD — FQDD of the selected PCIe slot or Virtual Adapter. Example • Displays FQDDs of all the PCIe slots and PCIe Virtual Adapters: racadm getpciecfg <PCIe Slot#>...
SLOT-02 SLOT-03 SLOT-04 SLOT-01 SLOT-02 SLOT-03 SLOT-04 • Displays the properties of a PCIe slot selected using FQDD: racadm getpciecfg -c pcie.chassisslot.1 • Displays the properties of a Virtual Adapter selected using FQDD: racadm getpciecfg -c RAID.ChassisIntegrated.2-1-4 getpminfo Description Displays power management status information. To use this subcommand, you must have CMC Login User privilege.
Overall Power Health = OK Redundancy = No [System Power Policy Configuration] System Input Power = 7928 W (7928 BTU/hr | 10%) Surplus for Peak Performance = 7000 W (6130 BTU/hr) Redundancy Policy = None Dynamic PSU Engagement Enabled = No [Power Budgeting] System Input Max Power Capacity...
• Displays 3 records from record number 5: racadm getraclog -s 5 -c 3 getractime Description Displays the current iDRAC time. Synopsis • racadm getractime [-d] • racadm getractime [-d] [-z] [-n] Input • -d — Displays the time in the format, yyyymmddhhmmss.mmmmmms. •...
• -s — Specifies the starting record used for the display. • -E — Displays RAW SEL data with the other data for each entry. • -R — Displays only RAW SEL data for each entry. • -i — Displays the number of entries in the SEL. •...
Webserver01 WXP-8GRB221 Webserver3 WXP-319QWEecet5 SLOT-04 • Display the name of the third slot. racadm getslotname -i 3 • Verify if the option (1 is Active) for displaying host names is set. getssninfo Description Displays a list of users that are connected to iDRAC. The following information is displayed: •...
NOTE: The Hostname and OS Name fields in the getsysinfo output display accurate information only if Dell OpenManage Server Administrator is installed on the managed system. Else, these fields may be blank or inaccurate. An exception to this are VMware operating system names, which are displayed even if Server Administrator is not installed on the managed system.
System Model = PowerEdge VRTX System AssetTag = 00000 Service Tag Express Service Code Chassis Name = CMC- Chassis Location = [UNDEFINED] Chassis Midplane Version = 1.0 Power Status = ON System ID = 1487 Examples racadm getsysinfo -d racadm getsysinfo -c...
Page 57
NOTE: The -b, -c and -l options are not available for CMC modules. NOTE: The -l option requires that the Lifecycle Controller service is enabled on the servers. For version information, see the RACADM Readme available at dell.com/support/manuals. • (none) — Displays the version information for all targets or devices.
– switch-n, where n = 1 – CMC-n, where n = 1 or 2 – mainboard – perc – expander – – perc-fqdd, where fqdd is FQDD of the PERC. – expander-fqdd, where fqdd is FQDD of the Storage Expander. –...
license Manages the CMC licenses. Description racadm license <license command type>. The command type can be: Synopsis • View the license using the following options: – racadm license view – racadm license view [-c <component>] • racadm license import [-u <username>] [-p <password>] [- f <license file name>] [-l <NFS or CIFS share>] [-c <FQDD>] •...
Page 62
View all the license information in the chassis. racadm license view CMC.Integrated.1 Status = OK Device = CMC.Integrated.1 Device Description = Chassis Management Controller for PowerEdge VRTX Unique Identifier License #1 Status = OK Transaction ID License Description CMC Enterprise Evaluation License License Type...
– Export the license to a CIFS share specifying the entitlement ID (for example, abcdxyz): racadm license export -u admin -p passwd -f License.xml -l //192.168.2.140/licshare -e abcdxyz – Export license to a CIFS share specifying the FQDD. While using the -c option and exporting licenses from a device, more than one license file must be exported.
ping6 Description Verifies that the destination IPv6 address is reachable from an iDRAC or CMC, or with the current routing-table contents. A destination IPv6 address is required. An ICMP echo packet is sent to the destination IPv6 address on the basis of current routing-table contents.
Page 66
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] Power Status = ON =============================================================================== Session Information =============================================================================== Type User...
NOTE: To use this, you must have the Chassis Administrator privilege. Synopsis racadm racreset [-m <module>] [-c <feature>] Input • -m : <module> — Must be one of the following values: – chassis — default state, if -m is not specified. –...
Page 69
• Monitor and Inventory all Controllers connected to the server racadm raid get controllers racadm raid get controllers -o This command is an optimized version and displays the full controller objects along with their keys. racadm raid get controllers -o -p <property names separated by comma> This command displays the filtered property values for all returned controller objects.
Page 70
This command is an optimized version and displays all disk objects for the enclosure FQDD. racadm raid get pdisks --refkey <enclosure/Backplanes FQDDs separated by comma > -o -p <property names separated by comma> optimized and filtered version. • Monitor and Inventory all Fans connected to the enclosure racadm raid get fans --refkey <enclosure FQDDs separated by comma>...
blink Starts blinking or identifies operation on the specified device. Description Synopsis racadm raid blink:<PD FQDD> racadm raid blink:<VD FQDD> racadm raid blink {-pdkey:<comma separated PD FQDDs|-vdkey:<comma separated VD FQDDs} Input • –pdkey: A comma-seperated list of physical disk drive FQDDs to use in the operation. •...
• –size: <VD size>: The size of the VD. • b: Specify the size in bytes. • k: Specify the size in kilobytes. • m: Specify the size in megabytes. • g: Specify the size in gigabytes. • t: Specify the size in terabytes. •...
Input • –l<CIFS or NFS share>: The network share to write the log to. • –u<username: The network username for the share. • –p <password>: The network password for the share • –f <filename>: The file name to write the log to. Example racadm raid exportlog:RAID.ChassisIntegrated.1-1 -l <CIFS or NFS share>...
cancelinit Stops an initialization operation on the specified virtual drive. Description Synopsis racadm raid cancelinit:<VD FQDD> {-current | -pending} Input • –current <optional>: Immediately performs the configuration operation. NOTE: If this requires the system to restart, the system will be restarted. •...
• –vdkey:<VD FQDD>: The Virtual Drive to change the access to. Example racadm raid assignva:RAID.ChassisIntegrated.1-1-1 - vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -accesspolicy { na | rw } racadm raid assignva:RAID.ChassisIntegrated.1-1-2 - vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -accesspolicy rw - assignpolicy multiple unblink Stops blinking or identifies an operation on the specified device. Description Synopsis racadm raid unblink:<PD FQDD>...
raid Description Monitors, retrieves inventory, and configures the storage components connected to the chassis. NOTE: To use this subcommand, you must have the Chassis Administrator privilege. racadm raid get status Synopsis racadm raid get <Object type> racadm raid get <Object type> -o racadm raid get <Object type>...
Page 77
• racadm raid get controllers -o -p name,status • racadm raid get vdisks -o -p layout,status • racadm raid get controllers:RAID.ChassisIntegrated.1-1 • racadm raid get controllers:RAID.ChassisIntegrated.1-1 - p status • racadm raid resetconfig:RAID.ChassisIntegrated.1-1 • racadm raid exportlog:RAID.ChassisIntegrated.1-1 -l <CIFS or NFS share> -u <user name> -p <password> [-f <filename>] •...
raid Description Allows you to execute commands to control RAID arrays. To use this subcommand for CMC you must have Chassis Administartor privilege. Synopsis racadm raid Example • Monitor Health of Storage root node racadm raid get status Storage Root Node Status : Ok This command retrieves the controllers keys, (FQDDs.) •...
Page 79
This command displays all enclosure keys connected to the connectors being mentioned as refkeys. racadm raid get enclosures --refkey <connector FQDDs separated by comma > -o optimized version. This command displays all enclosure objects for the connector FQDD. racadm raid get enclosures --refkey <connector FQDDs separated by comma >...
This command is an optimized version and displays all temperature probe objects for the enclosure FQDD. racadm raid get tempprobes -refkeys <enclosure FQDDs separated by comma > -o -p <property names separated by comma> optimized and filtered version • Monitor and Inventory all Power Supply Units connected to the enclosure racadm raid get psus --refkey <enclosure FQDDs separated by comma>...
remoteimage Description Connects, disconnects, or deploys a media file on a remote server. To use this subcommand, you must have the Administrator permission. Synopsis racadm remoteimage <options> Input • -c - Connect the image. • -d - Disconnect the image. •...
— powerup — Turns on the managed system. — powerstatus — Displays the current power status of the server (ON or OFF). — reseat — Performs a virtual reseat of the server. This operation simulates reseating the server by resetting the iDRAC on a server. NOTE: The action powerstatus is not allowed with an -a option.
Example • –Configure event filter configurations from a configuration file. racadm -r 10.94.161.119 -u root -p calvin set -f config.txt setassettag Description Sets the N-byte ASCII asset tag for the chassis. To use this subcommand, you must have the Administrator privilege. Synopsis racadm setassettag -m chassis <asset tag>...
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 use this command. Synopsis racadm setflexaddr [-i <slot#>...
• racadm setled -m server-9 -1 1 ERROR: Server in slot 9 is an extension of the server in slot 1. setniccfg Description Sets the iDRAC IP address. It displays an error message if the requested operation could not be performed, or a success message, if the operation is completed successfully.
• FQDD — FQDD of the specified PCIe slot or Virtual Adapter. Example • Assign a PCIe slot to a server: racadm setpciecfg assign -c pcie.chassisslot.5 -i 2 • Assign the Virtual Adapter to a server: racadm setpciecfg assign -c RAID.ChassisIntegrated.1-1-2 -i 3 •...
NOTE: 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 Dell OpenManage Server Administrator User's Guide at more information, see the support.dell.com/manuals.
< extended ASCII chassis name or location. • -c — Sets the chassis name or location. Example racadm setsysinfo -c chassisname "Dell Rack System" The chassis name was set successfully. SSH or Telnet RACADM racadm getconfig -g <groupname> [-o <objectname>] [-i <indexnumber>]...
Page 89
Remote RACADM: racadm sshpkauth -i <2 to 16> -k <1 to 4> -f <filename> racadm sshpkauth -i <2 to 16> -k <1 to 4> -t <key-text> Telnet/ssh/serial RACADM: racadm sshpkauth -i <2 to 16> -k <1 to 4> -t <key-text> View The view mode allows the user to view a key specified by the user or all keys.
• Get all keys for User 2 on iDRAC: $ racadm sshpkauth -v -i 2 -k all ********************* User ID 2 ****************** Key ID 1: ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzzy +k2npnKqVEXGXIzo0sbR6JgA5YNbWs3ekoxXV fe3yJVpVc/5zrrr7XrwKbJAJTqSw8Dg3iR4n3vUaP +lPHmUv5Mn55Ea6LHUslAXFqXmOdlThd wilU2VLw/iRH1ZymUFnut8ggbPQgqV2L8bsUaMqb5PooIIvV6hy4isCNJU= 1024-bit RSA, converted from OpenSSH by xx_xx@xx.xx Key ID 2: Key ID 3: Key ID 4: sslkeyupload...
Output racadm sslcertview -t 1 Serial Number Subject Information: Country Code (CC) State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit Remote Access Group (OU) Common Name (CN) iDRAC Default certificate Issuer Information: Country Code (CC)
State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit Remote Access Group (OU) Common Name (CN) iDRAC Default certificate Common Name (CN) iDRAC Default certificate Valid From Jul 8 16:21:56 2005 GMT Valid To Jul 7 16:21:56 2010 GMT...
• -s — Returns the status of a CSR generation process (generation in progress, active, or none). • -f — Specifies the filename of the location, filename >, where the CSR is downloaded. < NOTE: If the -f option is not specified, the filename defaults to sslcsr in your current directory.
Output Success: Test e-mail sent successfully Failure: Unable to send test e-mail Example Commands for the cfgEmailAlert group: • Enable the alert — racadm config -g cfgEmailAlert -o cfgEmailAlertEnable -i 1 • Set the destination e-mail address — racadm config -g cfgEmailAlert -o cfgEmailAlertAddress -i 1 user1@mycompany.com •...
Page 95
optional -d switch to obtain additional diagnostic information, as needed. This subcommand when executed performs the following: • Checks command syntax. • Verifies whether the required system resources are available. • Validates Active Directory configuration. • Verifies the SSL certificate and if the certificate signing request (key) exists.
• Verifies if the CMC can acquire CMC, LDAP and Global Catalog servers FQDN through reverse IP lookups. • Verifies that the CMC principal name matches the principal name in the uploaded Keytab file. • Verifies that the CMC acquires a Kerberos TGT. •...
• View the current test trap settings racadm getconfig -g cfgIpmiPet -i <index> index > is a number from 1 to 4. where < traceroute Description Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv4 address.
Chassis Management Controller. idRacDescriptionInfo (Read Only) Description A text description of the RAC type. Legal Values A string of up to 255 ASCII characters. Default This system component provides a complete set of remote management functions for Dell PowerEdge servers.
idRacVersionInfo (Read Only) Description String containing the current product firmware version. Legal Values A string of up to 63 ASCII characters. Default The current version number. idRacBuildInfo (Read Only) Description String containing the current RAC firmware build version. Legal Values A string of up to 16 ASCII characters.
cfgNicVLanId (Read or Write) Description Specifies the VLAN ID for the network VLAN configuration (in CMC for iDRAC Enterprise on server modules). This property is only valid if cfgNicVLanEnable is set to 1 (enabled). Legal Values 1 – 4000 and 4021 – 4094 Default Example racadm config -g cfgLanNetworking -o...
blank > Default < cfgDNSRacName (Read/Write) Description Displays the CMC name, which is rac-service tag by default. This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE). Legal Values A string of up to 63 ASCII characters. At least one character must be alphabetic.
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 cfgDNSServersFromDHCP (Read/Write) Description Specifies if the DNS server IPv4 addresses should be assigned from the DHCP server on the network. For CMC, this property is used only if cfgNicUseDhcp is set to 1 (true).
cfgDNSServer2 (Read/Write) Description Retrieves the IPv4 address for DNS server 2. This parameter is only valid if cfgDNSServersFromDHCP is set to 0 (FALSE). NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses. Legal Values String representing a valid IPv4 address. For example: 192.168.0.20.
cfgNicGateway (Read/Write) Description CMC gateway IPv4 address. The gateway IPv4 address used for static assignment of the RAC IP address. This property is only valid if cfgNicUseDhcp is set to 0 (FALSE). NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE).
Default For IPv4, it is 0.0.0.0 cfgRhostsFwUpdatePath (Read/Write) Description Specifies TFTP path where CMC firmware image file exists on the TFTP server. The TFTP path is relative to the TFTP root path on the TFTP server. NOTE: The server may still require you to specify the drive (for example, C:).
Default Null cfgRhostsNtpServer3 Description Specifies the third of three possible NTP servers. Legal Values A string representing a valid NTP server. For example, ntp3.ntp.net. At least one NTP server must be specified and duplicate entries are not allowed. Default Null cfgRhostsNtpMaxDist Description Specifies the NTP maximum distance parameter used to...
cfgRhostsSyslogServer1 (Read/Write) Description Specifies the first of three possible remote syslog servers to store the RAC and SEL logs.This property is only valid if cfgRhostsSyslogEnable is set to 1 (enabled). Legal Values Valid hostname or IPv4 or IPv6 address. blank > 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 who are allowed to access CMC through the available remote interfaces.
Page 110
The table below describes the user privilege bit values that can be combined to create bit masks. Legal Values 0x0000000-0x0000fff, and 0x0 Default 0x00000000 Example racadm getconfig -g cfgUserAdmin -i 1 # cfgUserAdminIndex=1 cfgUserAdminEnable=1 cfgUserAdminUserName=root # cfgUserAdminPassword=******** (Write-Only) cfgUserAdminPrivilege=0x00000fff The following table lists the bit masks for user priveleges. iDRAC Specific User Privilege Privilege Bit Mask Login to iDRAC...
User Privilege(s) Privilege Bit Mask The user is not allowed to access CMC. 0x00000000 The user may only log in to CMC and view CMC and server 0x00000001 configuration information. The user may log in to CMC and change configuration. 0x00000001 + 0x00000002 = 0x00000003 The user may log in, access Virtual Media, and Virtual Console.
The e-mail name can refer to an individual, group, location, department, and so on. Legal Values A string of up to 32 characters Default < blank > 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. One instance of the group is allowed. Displays current settings for and configures idle timeout properties for Web server, Telnet, SSH, and RACADM sessions. Changes to idle timeout settings take effect at the next login. To disable idle timeout for a connection, set this property to 0.
cfgSerialConsoleColumns Description Specifies the number of columns in the terminal window command line connected to the serial port. You must log out, then log in again for the changes to take effect. NOTE: The prompt counts as two characters. NOTE: The terminal emulator must be configured with the line wrap mode ON, if a terminal emulator is used.
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 MIB. Use this object with the config or getconfig subcommands.
NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option. cfgTrapsIndex (Read Only) Description Indicates the unique index of an alert instance. Legal Values 1 - 4 Default cfgTrapsEnable...
Use this object with the config or getconfig subcommands. To use this object property for CMC, you must have Chassis Configuration Administrator privilege. NOTE: For CMC, you can configure any setting that is not preceded by the hash sign (#) in the output. To modify a configurable object, use the -o option.
cfgRacTuneIpRangeEnable (Read/Write) Description Enables or disables the IPv4 Address Range validation feature. Legal Values • 1 (TRUE) • 0 (FALSE) Default cfgRacTuneIpRangeAddr (Read/Write) Description Specifies the acceptable IPv4 address bit pattern in positions determined by the 1s in the range mask property (cfgRacTuneIpRangeMask).
Default cfgRacTuneIpBlkFailCount (Read/Write) Description The maximum number of login failures to occur within the window (cfgRacTuneIpBlkFailWindow) before login attempts from the IP address are rejected. Legal Values 2 – 16 Default cfgRacTuneIpBlkFailWindow (Read/Write) Description Defines the time span in seconds that the failed attempts are counted.
cfgRacTuneDaylightOffset (Read Only) Description Specifies the daylight savings offset (in minutes) to use for the RAC Time. This value is 0 if the time zone is not a Daylight Saving time zone. Legal Values 0 – 60 Default Example racadm getconfig -g cfgRacTuning [-m server-<n>] -o <object name>...
cfgRacTuneIpBlkEnable=0 cfgRacTuneIpBlkFailCount=5 cfgRacTuneIpBlkFailWindow=60 cfgRacTuneIpBlkPenaltyTime=300# cfgRacTuneTimezoneOffset=-18000# cfgRacTuneDaylightOffset=3600 cfgRacTuneWebserverEnable (Read/Write) Description Enables or disables the Web server. If this property is disabled, CMC is not accessible using client Web browsers. This property has no effect on the Telnet/SSH or RACADM interfaces. Legal Values •...
Default None cfgServerName (Read/Write) Description Displays the name of the specified server. Legal Values Maximum of 15 non-extended ASCII characters, (ASCII codes 32–126). For more information, see Guidelines to Quote Strings Containing Special Characters when Using RACADM Commands. slot number > Default SLOT - <...
cfgServerNic3MacAddress (Read Only) Description Displays the MAC address of the server NIC 3. Legal Values None Default None cfgServerNic4MacAddress (Read Only) Description Displays the MAC address of the server NIC 4. Legal Values None Default None cfgServerPriority (Read/Write) Description Sets the priority level allotted to the server in the chassis for power budgeting purposes.
• 0 (Disable) Default None cfgServerDNSRegisterIMC (Read/Write) Description Enables or disables DNS name registration for the Integrated System (iDRAC). Legal Values • 1 (enable) • 0 (disable) Default None cfgServerDNSIMCName (Read/Write) Description Displays the DNS domain name for the integrated Remote Access Controller (iDRAC.) Legal Values None...
cfgADRootDomain Description Specifies the root domain of the domain forest. Legal Values Any printable text string of up to 254 characters, with no white space. Default < blank > cfgADEnable (Read/Write) Description Enables or disables Active Directory user authentication on CMC. If this property is disabled, LDAP authentication may be used for user login.
Default cfgADSpecifyServerEnable Description Allows you to enable or disable and specify an LDAP server or a global catalog server. Use cfgADDomainController or cfgADGlobalCatalog to specify the IP address. Legal Values • 1 (enabled) • 0 (disabled) Default cfgLDAP This group allows you to configure settings related to the Lightweight Directory Access Protocol (LDAP). Use this object with the config or getconfig subcommands.
Default Null cfgLdapPort (Read/Write) Description Port of LDAP over SSL. Non-SSL port is not supported. Legal Values 1 - 65535 Default cfgLdapBasedn (Read/Write) Description The Domain Name of the branch of the directory where all searches should start from. Legal Values String.
cfgLdapBinddn (Read/Write) Description The distinguished name of a user used to bind to the server when searching for the login user's DN. If not provided, an anonymous bind is used. This is optional but is required if anonymous bind is not supported. NOTE: If cfgLDAPBindDN is [null] and cfgLDAPBindPassword is [null], then the CMC attempts an anonymous bind.
cfgLDAPNetworkTimeout Description Configures the network timeout in seconds. Legal Values Positive integer Default 30 seconds cfgLDAPSearchTimeout Description Configures the search timeout in seconds. Legal Values Positive integer Default 120 seconds cfgLDAPSRVLookupDomainName Description Configures the domain name to be used in the SRV lookup. Legal Values String of maximum length of 254 alphanumeric characters and hyphens.
This group configures Generic LDAP Role group descriptions and defines the CMC privileges that LDAP–authenticated users are granted. cfgLDAPRoleGroup is indexed, containing instances numbered from 1 to 5. Each object instance consists of a pair of properties: • cfgLDAPRoleGroupDN: an LDAP distinguished name (DN) •...
Default cfgLocationAisle (Read/Write) Description Indicates aisle where server is located. Legal Values String of up to 128 ASCII characters Default cfgLocationRack (Read/Write) Description Indicates rack where server is located. Legal Values String of up to 128 ASCII characters Default cfgLocationRackslot (Read/Write) Description Indicates the slot where a server is located.
cfgSSADRoleGroupName (Read/Write) Description Name of the Role Group as recorded in the Active Directory forest. Legal Values Any printable text string of up to 254 characters with no white space. Default < blank > cfgSSADRoleGroupDomain (Read/Write) Description Active Directory Domain in which the Role Group resides. Legal Values Any printable text string of up to 254 characters, with no white space.
cfgChassisPower This group is applicable only to CMC and contains parameters to display or configure power for the chassis. 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 any setting that is not preceded by the hash sign (#) in the output.
cfgChassisPeakPowerTimestamp (Read Only) Description The timestamp recorded when the peak input power consumption value occurred. Legal Values Default cfgChassisMinPower (Read Only) Description The minimum system input power consumption value (in Watt) over the time since the value was last cleared. Legal Values None Default...
cfgChassisPowerCap (Read/Write) Description Indicates the maximum power consumption limit (in Watt) for the entire chassis. The command generates an error if server throttling is necessary to achieve the power goal based on the value for this setting. Legal Values 2715 – 16685 Watt Default 16685 Watt cfgChassisPowerCapF (Read/Write)
cfgChassisPowerCapFPercent (Read/Write) Description Indicates the power consumption limit as a percentage. The percentage is computed mathematically as the minimum power + (percent * (maximum power - minimum power)). Use cfgChassisPowerCapFPercent when power consumption is to be changed regardless of whether server throttling is required.
cfgChassisMaxPowerConservationMode (Read/Write) Description Enables or disables maximum power conservation mode. When enabled, all servers are immediately reduced to their minimum power levels, and all subsequent server power allocation requests are denied. In this mode, performance of the servers that are turned on may be degraded, and additional servers cannot be turned on, regardless of the server priority.
cfgChassisInPowerServerAllocation (Read Only) Description Indicates (in Watt) the cumulative power allocated to servers. There is no default as this parameter is very specific to the particular customer configuration. Legal Values None Default None cfgChassisInfrastructureInPowerAllocation (Read Only) Description Indicates the estimated cumulative DC output power consumption (in watts), determined from a field replaceable unit (FRU) on the hardware modules in the chassis.
cfgChassisPowerButtonEnable (Read/Write) Description Indicates if the chassis power button is enabled or disabled. Legal Values • 0 (disabled) • 1 (enabled) Default None cfgChassisPowerCapBTU (Read/Write) Description Indicates the maximum power consumption limit (in BTU/hr) for the entire chassis. The command generates an error if server throttling is necessary to achieve the power goal based on the value for this setting.
• cfgKvmSlot2Enable • cfgKvmSlot3Enable • cfgKvmSlot4Enable Legal Values 0 disables the mapping and 1 enables the mapping. Default None cfgDvdInfo This group is used to view the mapping information for the DVD drive in the chassis. Use this object with the config or getconfig subcommands. To use this object property, you must have the Chassis Configuration Administrator privilege.
cfgLcdLocale Read or Write Description Set the locale for the menu in the LCD: Legal Values • • • • • • zh-cn Default cfgLcdOrientation Read or Write Description Set the viewing angle of the LCD based on the orientation of the chassis (Tower or Rack).
Default cfgIPv6Address1 (Read/Write) Description Specifies the IPv6 address. Legal Values String representing a valid IPv6 entry. Default cfgIPv6Gateway (Read/Write) Description CMC gateway IPv6 address. NOTE: This property is used only if cfgIPv6AutoConfig is set to 0 (false.) Legal Values Specifies string representing a valid IPv6 entry. Default cfgIPv6PrefixLength (Read/Write) Description...
cfgIPv6DNSServersFromDHCP6 (Read/Write) Description Specifies whether cfgIPv6DNSServer1 and cfgIPv6DNSServer2 are static or DHCP IPv6 addresses. NOTE: This property is used only if cfgIPv6AutoConfig is set to 1 (true). Legal Values 1 (TRUE) 0 (FALSE) Default cfgIPv6DNSServer1 (Read/Write) Description Specifies the IPv6 DNS server address. NOTE: This property is used only if cfgIPv6DNSServersFromDHCP6 is set to 0 (false).
If both IPv4 and IPv6 are enabled on the CMC, IPv6 DNS servers take priority. The order of preference for DNS servers • cfgIPv6DNSServer1 • cfgIPv6DNSServer2 • cfgDNSServer1 • cfgDNSServer2 cfgCurrentLanNetworking (Read Only) This group displays the current CMC NIC properties. Use this object with the getconfig subcommand.
cfgNicCurrentVlanEnable (Read Only) Description Indicates whether the VLAN is enabled. Legal Values 0- VLAN is disabled 1- VLAN is enabled Default None cfgNicCurrentVlanID (Read Only) Description Indicates the Current Virtual Lan ID Legal Values Integer Default None cfgNicCurrentVlanPriority (Read Only) Description Indicates the Current Virtual Lan Priority.
cfgDNSCurrentDomainName Description Displays the DNS domain name. Legal Values Default cfgNicCurrentIPv4Enabled Description Indicates whether IPv4 is enabled on the CMC. If the current property value is set to 0 (false), the remote network interfaces to the CMC are not accessible over IPv4.
cfgCurrentIPv6AutoConfigWasUsed Description Indicates whether auto configuration is used to obtain IPv6 settings, including stateless IPv6 address(es) and gateway. Legal Values 0 (static addressing is used) 1 (address is obtained from the DHCPv6 server and/or stateless auto configuration) Default None cfgCurrentLinkLocalAddress Description Displays the current IPv6 link-local address of the CMC.
Default cfgCurrentIPv6DNSServer2 Description Displays the IPv6 address for DNS server 2. Legal Values None Default None 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 for the RAC NIC or CMC.
Example racadm getconfig -g cfgNetTuning cfgNetTuningNicSpeed=100 cfgNetTuningNicFullDuplex=1 cfgNetTuningNicMtu=1500 cfgNetTuningNicAutoneg=1 cfgNetTuningNic100MB (Read/Write) Description Specifies the speed to use for the RAC NIC. This property is not used if cfgNetTuningNicAutoNeg is set to 0 (disabled). Legal Values • 0 (10 MBit) • 1 (100 MBit) •...
cfgRacSecCsrCommonName (Read/Write) Description Specifies the CSR Common Name (CN) that must be an IP or CMC name as given in the certificate. Legal Values A string of up to 254 characters. Default < blank > cfgRacSecCsrOrganizationName (Read/Write) Description Specifies the CSR Organization Name (O). Legal Values A string of up to 254 characters.