Dell Chassis Management Controller Version 1.0 for PowerEdge VRTX Guide de l'utilisateur

Chassis Management Controller Version 1.0 for Dell PowerEdge VRTX RACADM Command Line Reference Guide

cfgKvmSlot<num>Enable Read or Write...142cf

idRacVersionInfo (Read Only)Description String containing the current product firmware version.Legal Values A string of up to 63 ASCII characters.Defa

cfgNicVLanId (Read or Write)Description Specifies the VLAN ID for the network VLAN configuration (in CMC for iDRAC Enterprise on server modules). This

Default <blank>cfgDNSRacName (Read/Write)Description Displays the CMC name, which is rac-service tag by default. This parameter is only valid if

Example:racadm getconfig -g cfgLanNetworkingcfgNicEnable=1cfgNicIPv4Enable=1cfgNicIpAddress=192.168.22.101cfgNicNetmask=255.255.255.0cfgNicGateway=192

cfgDNSServer2 (Read/Write)Description Retrieves the IPv4 address for DNS server 2. This parameter is only valid if cfgDNSServersFromDHCP is set to 0 (

cfgNicGateway (Read/Write)Description CMC gateway IPv4 address.The gateway IPv4 address used for static assignment of the RAC IP address. This propert

Default For IPv4, it is 0.0.0.0cfgRhostsFwUpdatePath (Read/Write)Description Specifies TFTP path where CMC firmware image file exists on the TFTP serv

Default NullcfgRhostsNtpServer3Description Specifies the third of three possible NTP servers.Legal Values A string representing a valid NTP server. Fo

cfgRhostsSyslogServer1 (Read/Write)Description Specifies the first of three possible remote syslog servers to store the RAC and SEL logs.This property

Exampleracadm getconfig -g cfgRemoteHosts [-m server-<n>]cfgRhostsFwUpdateTftpEnable=1cfgRhostsFwUpdateIpAddr=0.0.0.0cfgRhostsFwUpdatePath=cfgRh

cfgCurrentIPv6DNSServer1... 15

The table below describes the user privilege bit values that can be combined to create bit masks.Legal Values0x0000000-0x0000fff, and 0x0Default 0x000

User Privilege(s) Privilege Bit MaskThe user is not allowed to access CMC. 0x00000000The user may only log in to CMC and view CMC and server configura

To use this object property for, you must have Chassis Configuration Administrator privileges.NOTE: You can configure any setting that is not preceded

cfgSessionManagementThis group contains parameters to configure the number of sessions that can connect to iDRAC. One instance of the group is allowed

cfgSerialBaudRate (Read/Write)Description Sets the baud rate on the serial port.Legal Values2400, 4800, 9600, 19200, 28800, 38400, 57600,115200Default

cfgSerialConsoleColumnsDescription Specifies the number of columns in the terminal window command line connected to the serial port. You must log out,

• 0 (FALSE)Default 0cfgOobSnmpThis group contains parameters to configure the SNMP agent and trap capabilities of CMC. One instance of the group is al

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.cfgTra

Use this object with the config or getconfig subcommands.To use this object property for CMC, you must have Chassis Configuration Administrator privil

cfgRacTuneIpRangeEnable (Read/Write)Description Enables or disables the IPv4 Address Range validation feature.Legal Values• 1 (TRUE)• 0 (FALSE)Default

12

Default 0cfgRacTuneIpBlkFailCount (Read/Write)Description The maximum number of login failures to occur within the window (cfgRacTuneIpBlkFailWindow)

cfgRacTuneDaylightOffset (Read Only)Description Specifies the daylight savings offset (in minutes) to use for the RAC Time. This value is 0 if the tim

cfgRacTuneIpBlkEnable=0cfgRacTuneIpBlkFailCount=5cfgRacTuneIpBlkFailWindow=60cfgRacTuneIpBlkPenaltyTime=300# cfgRacTuneTimezoneOffset=-18000# cfgRacTu

Default NonecfgServerName (Read/Write)Description Displays the name of the specified server.Legal Values Maximum of 15 non-extended ASCII characters,

cfgServerNic3MacAddress (Read Only)Description Displays the MAC address of the server NIC 3.Legal Values NoneDefault NonecfgServerNic4MacAddress (Read

• 0 (Disable)Default NonecfgServerDNSRegisterIMC (Read/Write)Description Enables or disables DNS name registration for the Integrated System (iDRAC).L

• iSCSI• VFLASH partition label• FDD• SDe• RFS (Remote File Share)Default No-OverridecfgServerBootOnce (Read/Write)Description Enables or disables the

# cfgServerFirstBootDevice=******** (Write-Only)# cfgServerBootOnce=******** (Write-Only)# cfgServerPowerConsumption=0racadm getconfig -g cfgServerInf

cfgADRootDomainDescription Specifies the root domain of the domain forest.Legal Values Any printable text string of up to 254 characters, with no whit

Default 1cfgADSpecifyServerEnableDescription Allows you to enable or disable and specify an LDAP server or a global catalog server. Use cfgADDomainCon

1IntroductionThis document provides information about the RACADM subcommands, supported RACADM interfaces, and property database groups and object def

Default NullcfgLdapPort (Read/Write)Description Port of LDAP over SSL. Non-SSL port is not supported.Legal Values 1 - 65535Default 636cfgLdapBasedn (R

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

cfgLDAPNetworkTimeoutDescription Configures the network timeout in seconds.Legal Values Positive integerDefault 30 secondscfgLDAPSearchTimeoutDescript

This group configures Generic LDAP Role group descriptions and defines the CMC privileges that LDAP–authenticated users are granted.cfgLDAPRoleGroup i

Default 0cfgLocationAisle (Read/Write)Description Indicates aisle where server is located.Legal Values String of up to 128 ASCII charactersDefault 0cf

cfgSSADRoleGroupName (Read/Write)Description Name of the Role Group as recorded in the Active Directory forest.Legal Values Any printable text string

cfgChassisPowerThis group is applicable only to CMC and contains parameters to display or configure power for the chassis.Use this object with the con

cfgChassisPeakPowerTimestamp (Read Only)Description The timestamp recorded when the peak input power consumption value occurred.Legal ValuesDefaultcfg

cfgChassisPowerCap (Read/Write)Description Indicates the maximum power consumption limit (in Watt) for the entire chassis. The command generates an er

cfgChassisPowerCapFPercent (Read/Write)Description Indicates the power consumption limit as a percentage. The percentage is computed mathematically as

Exampleracadm -r <racIpAddr> -u <username> -p <password> getconfig -g <groupname> idracinforacadm -r <racIpAddr> -u <

cfgChassisMaxPowerConservationMode (Read/Write)Description Enables or disables maximum power conservation mode. When enabled, all servers are immediat

cfgChassisInPowerServerAllocation (Read Only)Description Indicates (in Watt) the cumulative power allocated to servers. There is no default as this pa

cfgChassisPowerButtonEnable (Read/Write)Description Indicates if the chassis power button is enabled or disabled.Legal Values• 0 (disabled)• 1 (enable

• cfgKvmSlot2Enable• cfgKvmSlot3Enable• cfgKvmSlot4EnableLegal Values 0 disables the mapping and 1 enables the mapping.Default NonecfgDvdInfoThis grou

cfgAlertingEnableDescription Enables or disables event traps on the CMC.Legal Values• 1 (true)• 0 (false)Default NonecfgAlertingFilterMaskDescription

cfgLcdLocale Read or WriteDescription Set the locale for the menu in the LCD:Legal Values• en• de• es• fr• ja• zh-cnDefault encfgLcdOrientation Read o

Default ::cfgIPv6Address1 (Read/Write)Description Specifies the IPv6 address.Legal Values String representing a valid IPv6 entry.Default ::cfgIPv6Gate

cfgIPv6DNSServersFromDHCP6 (Read/Write)Description Specifies whether cfgIPv6DNSServer1 and cfgIPv6DNSServer2 are static or DHCP IPv6 addresses.NOTE: T

If both IPv4 and IPv6 are enabled on the CMC, IPv6 DNS servers take priority. The order of preference for DNS servers is:• cfgIPv6DNSServer1• cfgIPv6D

cfgNicCurrentVlanEnable (Read Only)Description Indicates whether the VLAN is enabled.Legal Values 0- VLAN is disabled1- VLAN is enabledDefault Nonecfg

Subcommand CMCchassislog No Noclosessn Yes Yesclrsel Yes Yescmcchangeover Yes Yesconfig Yes Yesconnect Yes Yesdeploy Yes Yeseventfilters Yes Yesfanoff

cfgDNSCurrentDomainNameDescription Displays the DNS domain name.Legal ValuesDefaultcfgNicCurrentIPv4EnabledDescription Indicates whether IPv4 is enabl

cfgCurrentIPv6AutoConfigWasUsedDescription Indicates whether auto configuration is used to obtain IPv6 settings, including stateless IPv6 address(es)

DefaultcfgCurrentIPv6DNSServer2Description Displays the IPv6 address for DNS server 2.Legal Values NoneDefault NoneExampleracadm getconfig -g cfgCurre

Exampleracadm getconfig -g cfgNetTuningcfgNetTuningNicSpeed=100cfgNetTuningNicFullDuplex=1cfgNetTuningNicMtu=1500cfgNetTuningNicAutoneg=1cfgNetTuningN

cfgRacSecCsrCommonName (Read/Write)Description Specifies the CSR Common Name (CN) that must be an IP or CMC name as given in the certificate.Legal Val

cfgRacSecCsrEmailAddr (Read/Write)Description Specifies the CSR email address.Legal Values A string of up to 254 characters.Default <blank>Examp

Subcommand CMCgetssninfo Yes Yesgetsvctag Yes Yesgetsysinfo Yes Yesgetversion Yes Yeshelp and help <subcommand> Yes Yesifconfig Yes Yesjobqueue

Subcommand CMCtestemail Yes Yestestfeature Yes Yestesttrap Yes Yestraceroute Yes Yestraceroute6 Yes YesOther Documents You May NeedTo access the docum

• Documentation for any components you purchased separately provides information to configure and install these options.• Any media that ships with yo

2RACADM Subcommand DetailsThis section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.Guidelines

Notes, Cautions, and WarningsNOTE: A NOTE indicates important information that helps you make better use of your computer.CAUTION: A CAUTION indicates

For single quotation marks:• No character escaping is necessary.• A single quotation mark cannot be used even with a backslash escaped.NOTE: An empty

racadm getsysinfo [-d] [-c] [-A] [-4] [-6]-----------------------------------------------------------Valid Options:-d : show CMC information-c : show

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 t

• 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-

chassisactionDescription Executes a power action on the chassis or a server.To use this subcommand, you must have the Chassis Control Administrator pr

Session executing this command cannot be ended.• -a — Closes all sessions.• -u <user name>— Close all sessions for a particular user name.– Remo

configDescription Allows you to set iDRAC configuration parameters individually or to batch them as part of a configuration file. If the data is diffe

connectDescription Connects to the switch or server serial console.Synopsis• racadm connect [-b] <server-n>• racadm connect [-b] <switch-n>

• -s <ipaddress subnet gateway> — Sets the IP address, subnet mask, and gateway for the specified server, separated by single spaces.– ipaddress

NOTE: The general format of an alert descriptor:cmc.alert.category.[subcategory].[severity]where, category is mandatory, but subcategory and severity

Contents1 Introduction...

• Display eventfilter configurations for a specific severity and subcategory. For example, a severity of warning in the subcategory licensing under au

• Increases fan speed by 50% of fan’s maximum speed. Minimum speed for fan is 65% of the maximum.racadm fanoffset -s medium• Sets fans to run at 100%

OutputAn example of output is given here.racadm featurecard -s Active CMC: The feature card inserted is valid, serial number = CN0H871T137401112222A00

InputNOTE: 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

• 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-

Module ID = ChassisSeverity = CriticalMessage = The control panel cable or interconnect is not connected or is improperly connected.---

getconfigDescription Retrieves iDRAC configuration parameters individually, or all iDRAC configuration groups may be retrieved and saved to a file.Sy

If errors are not encountered, this subcommand displays the contents of the specified configuration.Example• Displays all of the configuration propert

<Server#> <Presence> <DC1 Type> <DC1 State> <DC2 Type> <DC2 State>server-1 Present PCIe OK PCIe OKserver-2 Not Pre

4 Enabled Not Presentidrac System DisabledDisplay the current FlexAddress setting for slot 1.racadm getflexaddr -i 1Slot-1 server presence = PresentSl

getled...

• chassis• CMC activeExample For CMC:• racadm getled -m server-10<module> <LED state> server-10 Blinking• racadm getled -m chassis <mod

<Name> <Presence> <BMC MAC Address><NIC1 MAC Address><NIC2 MAC Address>server-1 Present 00:11:43:FD:B7:2A00:11:43:FD:B7:

Server-1-B Gigabit EthernetPresent Not InstalledNot InstallediSCSI Present Not InstalledNot InstalledServer-1-C Fibre Channel 4Present Not InstalledNo

<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

Blower-3 Present ON OK N/ABlower-4 Present ON OK N/APS-1 Present

• chassis : default state if -m is not specified• server-n : where n = 1 to 4• switch-n : where n = 1Examplegetniccfg NIC Enabled= 1IPv4 Enabled = 1

IPv4 settings:NIC Enabled = 1IPv4 Enabled = 1DHCP Enabled = 1IP Address = 10.35.0.64Subnet Mask = 255.255.255.0Gateway = 10.35

To use this subcommand, you must have the CMC Login User privilege.Synopsisracadm getpbinfo Exampleracadm getpbinfo[Power Budget Status]System Input P

• -c — Use this option to select a specific PCIe adapter or Virtual Adapter.• FQDD — FQDD of the selected PCIe slot or Virtual Adapter.Example• Displa

9 2 SLOT-02 29 3 SLOT-03 39 4 SLOT-04

raid...

Overall Power Health = OKRedundancy = No[System Power Policy Configuration]System Input Power Cap = 7928 W (7928 BTU/hr |10%)Surplus

• Displays 3 records from record number 5:racadm getraclog -s 5 -c 3getractimeDescription Displays the current iDRAC time.Synopsis• racadm getractime

• -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

Blower-4 N/A 2611 3000 2250 N/A N/ASensor Type : TemperatureSensor Units : Celsius<Sensor Name><Status><Reading><LW> <LC&g

2 Webserver01 WXP-8GRB221 3 Webserver3 WXP-319QWEecet5 4 SLOT-04• Display the name of the third slot.racadm getslotn

Exampleracadm getsvctaggetsysinfoDescriptionDisplays information related to CMC and chassis.NOTE: The Hostname and OS Name fields in the getsysinfo ou

System Model = PowerEdge VRTXSystem AssetTag = 00000Service Tag =Express Service Code =Chassis Name

NOTE: To use this subcommand, you must have CMC Login User privilege.Synopsis• racadm getversion• racadm getversion [-b | -c] [-m <module>]• rac

– switch-n, where n = 1– CMC-n, where n = 1 or 2– mainboard– perc– expander– hdd– perc-fqdd, where fqdd is FQDD of the PERC.– expander-fqdd, where fqd

Example$ racadm ifconfigeth0 Link encap:Ethernet HWaddr 00:1D:09:FF:DA:23 inet addr:10.35.155.136 Bcast:10.35.155.255 Mask:255.255.

cfgDNSRegisterRac (Read/Write)...102cfg

Job Name=Reboot4Status=NewStart Time=[NOW]Expiration Time=[NOW]----------------------------------------------------------[Job ID=RID_852218430518]Job

licenseDescriptionManages the CMC licenses.Synopsisracadm license <license command type>. The command type can be:• View the license using the f

• -l — Network share location to import or export the license file.• -f — File name of the license file.NOTE: During export, the license file is named

– 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 /

U 0 0 1 lofe80::/64 :: U 256 0 0 eth1ff00::

ping6Description Verifies that the destination IPv6 address is reachable from an iDRAC or CMC, or with the current routing-table contents. A destinati

• Trace log information - gettracelog• RAC event log - getraclog• System event log - getselOutput The following information is displayed when the racd

<senType> <Num> <sensorName> <status> <reading> <units> <lc><uc>FanSpeed 1 Fan-1 OK

NOTE: To use this, you must have the Chassis Administrator privilege.Synopsisracadm racreset [-m <module>] [-c <feature>]Input• -m : <m

• Monitor and Inventory all Controllers connected to the serverracadm raid get controllersracadm raid get controllers -oThis command is an optimized v

cfgSerialConsoleEnable (Read/Write)... 114cfgS

This command is an optimized version and displays all disk objects for the enclosure FQDD.racadm raid get pdisks --refkey <enclosure/BackplanesFQDD

blinkDescriptionStarts blinking or identifies operation on the specified device.Synopsisracadm raid blink:<PD FQDD>racadm raid blink:<VD FQDD

• –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:

Input• –l<CIFS or NFS share>: The network share to write the log to.• –u<username: The network username for the share.• –p <password>:

cancelinitDescriptionStops an initialization operation on the specified virtual drive.Synopsisracadm raid cancelinit:<VD FQDD> {-current | -pend

• –vdkey:<VD FQDD>: The Virtual Drive to change the access to.Exampleracadm raid assignva:RAID.ChassisIntegrated.1-1-1 -vdkey:Disk.Virtual.0:RAI

raidDescription Monitors, retrieves inventory, and configures the storage components connected to the chassis.NOTE: To use this subcommand, you must h

• racadm raid get controllers -o -p name,status• racadm raid get vdisks -o -p layout,status• racadm raid get controllers:RAID.ChassisIntegrated.1-1• r

raidDescription Allows you to execute commands to control RAID arrays.To use this subcommand for CMC you must have Chassis Administartor privilege.Syn

This command displays all enclosure keys connected to the connectors being mentioned as refkeys.racadm raid get enclosures --refkey <connector FQDD

cfgServerNic2MacAddress (Read Only)...123cfgServe

This command is an optimized version and displays all temperature probe objects for the enclosure FQDD.racadm raid get tempprobes -refkeys <enclosu

remoteimageDescription Connects, disconnects, or deploys a media file on a remote server.To use this subcommand, you must have the Administrator permi

— powerup — Turns on the managed system.— powerstatus — Displays the current power status of the server (ON or OFF).— reseat — Performs a virtual rese

Example• –Configure event filter configurations from a configuration file. racadm -r 10.94.161.119 -u root -p calvin set -f config.txtsetassettagDesc

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

• racadm setled -m server-9 -1 1ERROR: Server in slot 9 is an extension of the server in slot 1.setniccfgDescription Sets the iDRAC IP address. It dis

• 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

— <timezone> is the case-sensitive name of your timezone or the index listed by '-z timezone-prefix*'.— <timezone-prefix*> is a

• <enabled> — Sets whether the server's host name is used for display purposes. Valid values: 0 or 1.Example• Set the name of slot 3 as ser

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

cfgLocationDatacenter (Read/Write)...133cfgL

• Get all keys for User 2 on iDRAC:$ racadm sshpkauth -v -i 2 -k all********************* User ID 2 ******************Key ID 1:ssh-rsa AAAAB3NzaC1y

• -e — Allows for upload of multiple certificate format types.– 1 = Base64– 2 = PKCS12The current release does not support this option.• -p — Pin for

State (S) TexasLocality (L) Round RockOrganization (O) Dell Inc.Organizational Unit (OU)Remote Access GroupCommon Name (CN) iDRAC Default certificateC

• -s — Returns the status of a CSR generation process (generation in progress, active, or none).• -f — Specifies the filename of the location, <fil

OutputSuccess: Test e-mail sent successfullyFailure: Unable to send test e-mailExample Commands for the cfgEmailAlert group:• Enable the alert — racad

optional -d switch to obtain additional diagnostic information, as needed.This subcommand when executed performs the following:• Checks command syntax

• Verifies if the CMC can acquire CMC, LDAP and Global Catalog servers FQDN through reverse IP lookups.• Verifies that the CMC principal name matches

• View the current test trap settingsracadm getconfig -g cfgIpmiPet -i <index>where <index> is a number from 1 to 4.tracerouteDescription

98

3CMC Property Database Group and Object DescriptionsThe CMC property database contains the configuration information for CMC. Data is organized by ass