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
Komentáře k této Příručce