Reference Guide

ManualsBrandsDell ManualsActive System ManagerChassis Management Controller Version 1.25 for Dell PowerEdge VRTX

Chassis Management Controller Version 1.25 for Dell

PowerEdge VRTX RACADM Command Line Reference

Guide

Summary of content (153 pages)

PAGE 1
Chassis Management Controller Version 1.
PAGE 2
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. VR_copyright © 2014 Dell Inc. All Rights Reserved.
PAGE 3
Contents 1 Introduction................................................................................................................................13 Supported RACADM Interfaces..............................................................................................................................13 RACADM Syntax Usage..........................................................................................................................................13 SSH or Telnet RACADM......................
PAGE 4
getled...................................................................................................................................................................... 38 getmacaddress....................................................................................................................................................... 39 getmodinfo..............................................................................................................................................................
PAGE 5
raid................................................................................................................................................................... 74 raid................................................................................................................................................................... 76 rebuild...............................................................................................................................................................
PAGE 6
cfgDNSRegisterRac (Read/Write)..................................................................................................................100 cfgDNSServersFromDHCP (Read/Write)....................................................................................................... 101 cfgDNSServer1 (Read/Write).........................................................................................................................101 cfgDNSServer2 (Read/Write).............................................
PAGE 7
cfgSerialConsoleEnable (Read/Write)........................................................................................................... 111 cfgSerialConsoleIdleTimeout (Read/Write)................................................................................................... 111 cfgSerialConsoleNoAuth (Read/Write).......................................................................................................... 112 cfgSerialConsoleCommand (Read/Write).......................................
PAGE 8
cfgServerNic2MacAddress (Read Only)........................................................................................................121 cfgServerNic3MacAddress (Read Only)........................................................................................................121 cfgServerNic4MacAddress (Read Only)........................................................................................................121 cfgServerPriority (Read/Write).....................................................
PAGE 9
cfgLdapGroupAttribute (Read/Write)............................................................................................................. 130 cfgLdapGroupAttributeIsDN (Read/Write).....................................................................................................130 cfgLdapBinddn (Read/Write)..........................................................................................................................131 cfgLdapBindpassword (Write Only).....................................
PAGE 10
cfgChassisInMaxPowerCapacity (Read Only)............................................................................................... 139 cfgChassisInRedundancyReserve (Read Only)..............................................................................................139 cfgChassisInPowerServerAllocation (Read Only)......................................................................................... 140 cfgChassisInfrastructureInPowerAllocation (Read Only).........................................
PAGE 11
cfgCurrentLinkLocalAddress..........................................................................................................................148 cfgDNSCurrentServer1.................................................................................................................................. 148 cfgDNSCurrentServer2.................................................................................................................................. 148 cfgDNSCurrentDomainName...........................
PAGE 12
PAGE 13
Introduction 1 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 Access Controller (RAC). The utility runs on the management station and the managed system.
PAGE 14
RACADM Command Options The following table lists the options for the RACADM command. Option Description -r -r racIpAddr : Specifies the controller’s remote IP address. Use: if the iDRAC port number is not the default port (443). -u Specifies the user name that is used to authenticate the command transaction. If the -u option is used, the -p option must be used, and the -i option (interactive) is not allowed.
PAGE 15
Subcommand CMC cmcchangeover Yes Yes config Yes Yes connect Yes Yes deploy Yes Yes eventfilters Yes Yes fanoffset Yes Yes feature Yes Yes featurecard Yes Yes fwupdate Yes Yes get No Yes getactiveerrors No Yes getassettag Yes Yes getchassisname Yes Yes getconfig Yes Yes getdcinfo Yes Yes getflexaddr Yes Yes getioinfo Yes Yes getled Yes Yes getmacaddress Yes Yes getmodinfo Yes Yes getniccfg Yes Yes getpbinfo Yes Yes getpciecfg Yes Yes getp
PAGE 16
Subcommand CMC getversion Yes Yes help and help Yes Yes ifconfig Yes Yes jobqueue Yes Yes krbkeytabupload No Yes license No Yes netstat Yes Yes ping Yes Yes ping6 Yes Yes racdump Yes Yes racreset Yes Yes racresetpcie Yes Yes racresetcfg Yes Yes raid Yes Yes remoteimage Yes Yes serveraction Yes Yes set No Yes setassettag Yes Yes setflexaddr Yes Yes setled Yes Yes setniccfg Yes Yes setpciecfg Yes Yes setractime Yes Yes setslot
PAGE 17
Subcommand CMC traceroute Yes Yes traceroute6 Yes Yes 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. • The VRTX CMC Online Help provides information about using the Web interface. To access the Online Help, click Help on the CMC web interface.
PAGE 18
Updates are sometimes included with the system to describe changes to the system, software, and/or documentation. Always read the updates first, because they often supersede information in other documents. Accessing Documents From Dell Support Site You can access the required documents in one of the following ways: • • From the following links: – For all Systems Management documents — dell.com/softwaresecuritymanuals – For Enterprise Systems Management documents — dell.
PAGE 19
RACADM Subcommand Details 2 This section provides detailed descriptions about the RACADM subcommands, including the syntax and valid entries.
PAGE 20
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). "?"and "?" Description Displays all the subcommands you can use with the RACADM command and a one-line description of each subcommand. ? followed by displays the syntax for the specified command.
PAGE 21
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 Description Synopsis Input Output Example Lists all the subcommands available for use with RACADM and provides a short description for each. You may also type a subcommand after help.
PAGE 22
• • • • • • -a - Specifies the FTP Server IP address or FQDN, user name, and password. -d - Specifies the path to the file on the FTP server. -l - Specifies the location of the network share or area on file system where chassis log is exported. Two types of network shares are supported: — SMB mounted path: //// — NFS mounted path: :/.
PAGE 23
racadm -r -u -p chassislog export -f -u -p l Input • • • • Example • –f : Filename of the exported Chassis Log. –u : Username for the remote share to where the file must be exported. Username in a domain can be given as domain/username –p : Password for the remote share to where the file must be exported.
PAGE 24
– – – – – powerdown — (Chassis only) Turns off the chassis. powerup — (Chassis only) Turns on the chassis. powercycle — Power cycles the module. nongraceshutdown — (Chassis only) Nongracefully turns off the chassis. reset — Performs a hard reset of the module. When = switch, must be powercycle or reset. Output None Example Perform a reset of switch-1: racadm chassisaction -m switch-1 reset Module power operation successful.
PAGE 25
clrsel Description Deletes all existing records from the System Event Log (SEL). To use this subcommand, you must have the Clear Logs privilege. Synopsis racadm clrsel cmcchangeover Description Changes the state of the CMC from active to standby, or vice versa, in a redundant CMC configuration. This subcommand is useful for remote debugging or testing purposes. To use this subcommand, you must have the Administrator privilege. NOTE: This command is valid only in redundant CMC environments.
PAGE 26
• • Output -i — The -i , or index option, is valid only for indexed groups and can be used to specify a unique group. The is a decimal integer from 1 through n, where n can vary from 1 to maximum number of indexes a particular group supports. If -i is not specified, a value of 1 is assumed for groups, which are tables that have multiple entries. The index is specified by the index value, not a named value.
PAGE 27
NOTE: You can also use setniccfg to configure static IP address, subnet mask, gateway, DHCP, speed, and duplex properties. Synopsis • • • • Input • • • • • • • • racadm deploy -m -u root -p -s -b -o racadm deploy -m -u root -p -s -6 -b -o where is a number between 0 and 128.
PAGE 28
• rracadm deploy -m server-7 -u root -p calvin -s -6 ::/ 64 :: 10 Displayable Characters Displayable characters include the following set: abcdefghijklmnopqrstuvwxwz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789~`!@#$%^&*()_+-={}[]|\:";'<>,.?/ eventfilters Description Gets, sets, and displays the list of event filter settings. To use this subcommand with the get option, you must have the CMC Login User privilege.
PAGE 29
Input • • • • • get - Displays the list of event filter settings. set - Configures the actions and notifications for a given event filter configuration. -c - Alert descriptor of the specific event filter. -n - The notification to be sent when the event occurs. Valid values are all, snmp, ipmi, lcd, email, or none. You can append multiple notifications separated by a comma. You cannot enter the values all or none with other notifications. -r - Event generation interval.
PAGE 30
fanoffset Description Configures the internal fans to run at a higher speed than the normal speed. To use this subcommand, you must have the Chassis Configuration Administrator privilege. Synopsis racadm fanoffset [-s Valid category values are: • • • • off low medium high Input s — Sets the fan speed. Example • Disable the fanoffset feature. racadm fanoffset -s off • Increases fan speed by 20% of fan’s maximum speed. Minimum speed for fan is 35% of the maximum.
PAGE 31
NOTE: When the FlexAddress and FlexAddressPlus features are active, deactivating one of them results in deactivation of the other feature also. However, ExtendedStorage is not affected by the deactivation of FlexAddress or FlexAddresPlus. • -r — Repair damaged/unformatted ExtendedStorage media. NOTE: The –r switch requires that the ExtendedStorage feature be deactivated. CAUTION: Using the -r switch reformats the SD media in the active CMC cardslot. Any existing ExtendedStorage data will be lost.
PAGE 32
To use this subcommand, you must have the Chassis Configuration Administrator privilege. NOTE: Running the subcommand to update the active CMC firmware resets the CMC, causing all network connections to get logged off. While updating all other modules, including the standby CMC, the active CMC continues to function normally without resetting. NOTE: The subcommand generates an error, when used on the extension slot of a multi-slot server.
PAGE 33
• – perc-fqdd, where fqdd is FQDD of the PERC – expander-fqdd, where fqdd is FQDD of the Storage Expander – hdd-fqdd, where fqdd is FQDD of the HDD -s — Displays the current status of the firmware update. NOTE: Use -m to display the status of the module update. Omit -m to display the status of the active CMC update. NOTE: Use all to get the status of all the targets that must be updated. • Output -c — Cancels the current firmware update of a module.
PAGE 34
NOTE: Currently, these commands are supported only in remote racadm. Synopsis racadm get -f Input –f : save event filter configurations to a file. Example –Save event filter configurations to a file by using remote racadm. racadm -r 10.94.161.119 -u root -p calvin get -f config.txt getactiveerrors Description Displays the active errors in a chassis. To run this subcommand, you must have the CMC Login User privilege.
PAGE 35
getchassisname Description Displays the name of the chassis. To use this subcommand, you must have the CMC Login User privilege. Synopsis racadm getchassisname Example racadm getchassisname CMC-1 getconfig Description Retrieves iDRAC configuration parameters individually, or all iDRAC configuration groups may be retrieved and saved to a file.
PAGE 36
• Output -v — The -v option displays additional details with the display of the properties and is used with the -g option. This subcommand generates error output upon encountering either of the following: • • Invalid syntax, group name, object name, index, or other invalid database members RACADM CLI transport failures If errors are not encountered, this subcommand displays the contents of the specified configuration.
PAGE 37
The following example is for a system with multi-slot servers.
PAGE 38
Example Display current FlexAddress settings for all the slots and fabrics. racadm getflexaddr 1 Enabled Present 2 Enabled Present 3 Enabled Not Present 4 Enabled Not Present idrac System Disabled Display the current FlexAddress setting for slot 1.
PAGE 39
To use this subcommand, you must have the Login User privilege. Synopsis racadm getled -m Input CMC only options: -m — Specifies the module whose LED settings you want to view.
PAGE 40
Display iSCSI MAC for server-1. racadm getmacaddress -m server-1 -t iscsi Display extra iSCSI MACs for server-1 (if available). racadm getmacaddress -m server-1 -t iscsi -x Display MAC for server-1. racadm getmacaddress -m server-1 server-1 Present 00:11:43:FD:B7: 00:11:43:FD:B7: 00:11:43:FD:B7: 2A 2A 2B server-4 Extension(1) N/A 00:11:43:FD:B7: 00:11:43:FD:B7: 2C 2D Display extra MACs for server-1 (if available).
PAGE 41
CMC N/A Present N/A 00:1E:4F:1F: N/A 3C:58 Server-1-A Gigabit Ethernet Present 00:1E:4F: 2A:AF:7B 00:1E:4F: 2A:D3:97 00:1E:4F: 2A:D3:99 iSCSI Present 00:1E:4F: 2A:D3:98 00:1E:4F: 2A:D3:9A Gigabit Ethernet Present Not Installed Not Installed iSCSI Present Not Installed Not Installed Server-1-C Fibre Channel 4 Present Not Installed Not Installed Server-2-A Gigabit Ethernet Present 00:22:19:D2: N/A 1E:84 N/A iSC
PAGE 42
getmodinfo Description Displays configuration and status information for all modules or a specified module (server, switch, CMC, fan unit, blower, power supply unit, chassis, DVD, main-board, IO cable, and FPC cable) in the chassis. To use this subcommand, you must have CMC Login User privilege. NOTE: The service tag field is blank for modules that do not have service tags.
PAGE 43
Fan-4 Present ON OK N/A Fan-5 Present ON OK N/A Fan-6 Present ON OK N/A Blower-1 Present ON OK N/A Blower-2 Present ON OK N/A Blower-3 Present ON OK N/A Blower-4 Present ON OK N/A PS-1 Present Online N/A N/A PS-2 Present Online OK N/A PS-3 Not Present N/A N/A N/A PS-4 Not Present N/A N/A N/A CMC-1 Present Standby OK N/A CMC-2 Present Primary N/A N/A Switch-1 Present ON N/A N/A Server-1 Present OFF OKA N/A Server-2 Not Present N/A
PAGE 44
• : where n = 1 to 4 switch-n : where n = 1 Example racadm 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.0.12 Current Subnet Mask = 255.255.254.0 Current Gateway = 10.36.0.
PAGE 45
Gateway = 0.0.0.0 Output The getniccfg subcommand displays an appropriate error message if the operation is not successful. Otherwise, the output is displayed in the following format: IPv4 settings: NIC Enabled = 1 IPv4 Enabled = 1 DHCP Enabled = 1 IP Address = 10.35.0.64 Subnet Mask = 255.255.255.0 Gateway = 10.35.0.
PAGE 46
getpbinfo Description Displays power budget status information. To use this subcommand, you must have the CMC Login User privilege.
PAGE 47
NOTE: To use this subcommand, you must have CMC Login User privilege. Synopsis racadm getpciecfg [-c ] Input • • • -a — Use this option to display the assignment of PCIe slots and Virtual Adapters. -c — Use this option to select a specific PCIe adapter or Virtual Adapter. FQDD — FQDD of the selected PCIe slot or Virtual Adapter.
PAGE 48
Unmapped N/A 9 1 SLOT-01 1 9 2 SLOT-02 2 9 3 SLOT-03 3 9 4 SLOT-04 4 10 10 10 10 1 2 3 4 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 1 2 3 4 getpminfo Description Displays power management status information.
PAGE 49
[System Power Status] Chassis Power State = ON Overall Power Health = OK Redundancy = No [System Power Policy Configuration] System Input Power Cap = 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 = 0 W Input Redundancy Reserve = 0 W Input Power Allocated to Servers = 0 W Input Power Allocated to Chassis Infrastructure = 51W Total Input Power Available for Allocation
PAGE 50
Example • Displays all the logs. racadm getraclog • Displays 3 records from record number 5: racadm getraclog -s 5 -c 3 getractime Description Displays the current iDRAC time. Synopsis Input • • racadm getractime [-d] racadm getractime [-d] [-z] [-n] • • • -d — Displays the time in the format, yyyymmddhhmmss.mmmmmms. -z — Displays timezone. This option is specific to CMC only. -n — Displays NTP peer information. This option is specific to CMC only.
PAGE 51
• • • • • • • -c — Provides the number of records to be displayed. -o — Displays each entry in the SEL in a single line. -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. --more — Displays one screen at a time and prompts the user to continue (similar to the UNIX more command.) NOTE: The -A, -E, -o, and -R options are deprecated.
PAGE 52
Blower-4 N/A 2611 3000 2250 N/A N/A Sensor Type : Temperature Sensor Units : Celsius Chassis Ambient OK 22 3 -7 42 47 Server-4 OK 20 3 -7 42 47 Sensor Type : Power PS-1 Slot Empty N/A PS-2 Online OK PS-3 Slot Empty N/A PS-4 Slot Empty N/A Sensor Type : Cable IO-Cable OK FPC-Cable OK Sensor Type : Intrusion Chassis Intrusion Closed getslotn
PAGE 53
2 3 4 Webserver01 Webserver3 SLOT-04 WXP-8GRB221 WXP-319QWEecet5 • 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.
PAGE 54
Example racadm getsvctag getsysinfo Description Displays information related to CMC and chassis. 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.
PAGE 55
System Model System AssetTag Service Tag Express Service Code Chassis Name Chassis Location Chassis Midplane Version Power Status System ID Examples = = = = = = = = = PowerEdge VRTX 00000 CMC[UNDEFINED] 1.0 ON 1487 racadm getsysinfo -d racadm getsysinfo -c racadm getsysinfo -A racadm getsysinfo -4 racadm getsysinfo -6 gettracelog Description Synopsis Input Lists all the trace log entries in iDRAC and CMC.
PAGE 56
NOTE: To use this subcommand, you must have CMC Login User privilege. Synopsis • • • racadm getversion racadm getversion [-b | -c] [-m ] racadm getversion -l [-m ] [-f ] Input 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.
PAGE 57
– – – – – – – Example mainboard perc expander hdd perc-fqdd, where fqdd is FQDD of the PERC. expander-fqdd, where fqdd is FQDD of the Storage Expander. hdd-fqdd, where fqdd is FQDD of the HDD.
PAGE 58
jobqueue Description Displays the jobs in that are currently being run, delete the jobs, and create a job. NOTE: To view the jobs, you must have CMC Login User privilege. NOTE: To delete the jobs, you must have Chassis Configuration Administrator privilege. Synopsis racadm jobqueue view racadm jobqueue delete racadm jobqueue create Input • • • • • • Example 58 • —i — Specifies the JobID that is displayed or deleted. – –all — The JobIDs that are not applied are deleted.
PAGE 59
• Delete the specified job: racadm jobqueue delete -i RID_860202993201 • Job being created to turn on the RAID controller installed in the chassis. racadm jobqueue create RAID.ChassisIntegrated.1-1 -r pwrup -s TIME_NOW -e 20120501100000 • racadm jobqueue delete -i krbkeytabupload Description Uploads a Kerberos keytab file. To use this subcommand, you must have the Configure iDRAC permission.
PAGE 60
• – racadm license delete [-e ] – racadm license delete [-c ] [-p ] [f ] [-1 ] [—t ] Input NOTE: License operations the name should be less than 56 Characters. NOTE: During Remote file share, SSH/telnet supports the Import and Export options.
PAGE 61
A2Wir6lJ1MoP8iBAtqsEKDv8 1982-04-07T21:00:00 – • • • • Expiration = Display licenses available on a specific device. For example, for RAID slot 4: racadm license view -c RAID.slot.4 Import a license: – Import a license from a CIFS share to a device (for example, Integrated CMC): racadm license import -u admin -p passwd -f License.xml -l //192.168.2.140/licshare -c cmc.integrated.1 – Import a license from an NFS share to a device (for example, Integrated CMC): racadm license import -f License.
PAGE 62
– Replace license on a device with a license file on the local file system. racadm license replace -f License.xml -t 27 netstat Description Displays the routing table and the current connections. To use this subcommand, you must have the Execute Diagnostic Commands permission.
PAGE 63
127.0.0.1:199 tcp 0 0 127.0.0.1:199 127.0.0.1:52175 tcp 0 0 10.94.161.120:22 10.94.115.237:45106 tcp 0 0 127.0.0.1:52174 127.0.0.1:199 tcp 0 0 127.0.0.1:52887 127.0.0.1:8195 ESTABLISHED ESTABLISHED ESTABLISHED ESTABLISHED ESTABLISHED ping Description Verifies that the destination IP address is reachable from iDRAC with the current routing-table contents. A destination IP address is required. An ICMP echo packet is sent to the destination IP address based on the current routing-table contents.
PAGE 64
racdump Description This subcommand displays the comprehensive chassis status and configuration state information, and historic event logs. Used for post-deployment configuration verification and during debugging sessions. To use this subcommand for CMC, you must have the Administrator privilege.
PAGE 65
DHCP Enabled MAC Address Current DNS Server 1 Current DNS Server 2 DNS Servers from DHCP Register DNS CMC Name DNS CMC Name Current DNS Domain = = = = = = = = 1 00:55:AB:39:10:0F 0.0.0.0 0.0.0.
PAGE 66
NOTE: To use this subcommand, you must have the Chassis Administrator privilege. NOTE: When you run a racreset subcommand, iDRAC may require up to two minutes to return to a usable state. NOTE: You must restart your system after performing a hard reset of iDRAC. Synopsis racadm racreset [-m ] Input (module) — server-n, where n=1–4. NOTE: You can specify multiple modules: -m –m . Example • Reset CMC: racadm racreset • Reset server 1.
PAGE 67
• Perform reset of configuration data to default for switch-1 module racadm racresetcfg -m switch-1 racresetpcie Description Resets the PCIe devices in the chassis to factory defaults. NOTE: To use this subcommand for CMC, you must have the Chassis Administrator privilege. racadm racresetpcie Synopsis raid Description Allows you to execute commands to control RAID arrays. To use this subcommand for CMC you must have Chassis Administartor privilege.
PAGE 68
• Monitor and Inventory all virtual disks connected to the controller racadm raid get vdisks --refkey This command displays all vdisk keys connected to the controllers being mentioned as refkeys. racadm raid get vdisks --refkey -o This command is an optimized version and displays all vdisk objects for the controller FQDD. racadm raid get -pending Raid.Integrated.1-1 Raid.Slot.
PAGE 69
This command is an optimized version and displays all EMM objects for the enclosure FQDD. racadm raid get emms -refkeys -o -p This command is an optimized and filtered version. • Monitor and Inventory all Temperature Probes connected to the enclosure racadm raid get tempprobes -refkeys This command displays all temperature probe keys connected to the enclosures being mentioned as refkeys.
PAGE 70
createvd Description Stops an initialization operation on the specified virtual drive. Synopsis racadm raid createvd: -rl {r0|r1|r5|r6|r10|r50| r60}[-wp {wt|wb}] [-rp {nra|ra|ara}] [-ss {1k|2k|4k|8k|16k|32k|64k|128k|256k|512k|1M|2M|4M|8M|16M}] -pdkey: [-dcp {enabled|disabled|default}] [-name:] [-size {b|k|m|g|t}] [-cc] {-current|pending} Input • • • • • • • • • • • • • • • • • • • • • • • • Example -rl: Set the RAID Level.
PAGE 71
• Example –pending: Save the configuration change for a later application. You can use a combination of the –pending and –current flags on multiple commands to reduce the possible number of system reboots. racadm raid deletevd:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 discardcache Description Discards any pinned or persistent cache present on the RAID controller.
PAGE 72
Example racadm raid forceonline:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 hotspare Description Stops blinking or identifies an operation on the specified device. Synopsis racadm raid hotspare: -assign {yes | no} {type {ghs | dhs}} {-vdkey:} {-current | -pending} Input • –current
PAGE 73
• Example –pending: Save the configuration change for a later application. You can use a combination of the –pending and –current flags on multiple commands to reduce the possible number of system rerestarts. racadm raid cancelrebuild:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 assignva Description Stops an initialization operation on the specified virtual drive. Assigns a virtual disk to one or more virtual adapters.
PAGE 74
racadm raid unblink -vdkey:Disk.Virtual.0:RAID.ChassisIntegrated. 1-1,Disk.Virtual.0:RAID.ChassisIntegrated.1-1 init Description Starts an initialization operation on the specified virtual drive. Synopsis racadm raid init: -speed {fast | full} {-current | pending} Input • –current : Performs the configuration right now. NOTE: If this requires the system to reboot it will reboot then. • • Example –pending: Save the configuration change for a later application.
PAGE 75
• • • Example • • • • • • • • • • • • • • • • • • – exportlog – forceonline – deletevd – blink – unblink – clearconfig – importconfig – ccheck – cancelcheck – patrolread – hotspare – init – assignva – createvd –o — Displays all the properties of the selected Key or Object. –p — Displays the property names with filter. FQDD — Displays all the properties of the FQDD's Key.
PAGE 76
• • • • • racadm raid createvd:RAID.ChassisIntegrated.1-1 -rl {r0|r1| r5|r6|r10|r50|r60} [-wp {wt|wb}] [-rp {nra|ra|ara}] [-ss {1k|2k|4k|8k|16k|32k|64k|128k|256k|512k|1M|2M|4M|8M|16M}] pdkey: [-dcp {enabled|disabled|default}] [-name ] [-size {b|k|m|g|t}] [-cc] racadm raid discardcache:RAID.ChassisIntegrated.1-1 racadm raid changepolicy:Disk.Virtual. 0:RAID.ChassisIntegrated.
PAGE 77
This command is an optimized and filtered version. racadm raid get batteries --refkey -o -p • Monitor and Inventory all virtual disks connected to the controller racadm raid get vdisks --refkey This command displays all vdisk keys connected to the controllers being mentioned as refkeys.
PAGE 78
This command will return all EMM keys connected to the enclosures being mentioned as refkeys. racadm raid get emms -refkeys -o This command is an optimized version and displays all EMM objects for the enclosure FQDD. racadm raid get emms -refkeys -o -p This command is an optimized and filtered version.
PAGE 79
resetconfig Description Removes the current RAID Configuration (Virtual Drives and Hotspares) from the RAID controller. This operation is not data-distructive, but is difficult to reverse. Synopsis racadm raid resetconfig: {-current|pending} Input • –current : Performs the configuration right now. NOTE: If this requires the system to reboot, then the system will reboot. Example • –pending: Save the configuration change for a later application.
PAGE 80
To use this subcommand, you must have the Execute Server Control Commands permission. Synopsis Input racadm serveraction • • • • -m server-n, where n=1–4 -a - Performs action on all servers. Not allowed with the powerstatus action. -f - Force the action. Required for the reseat action. - Specifies the action. The options for the string are: — graceshutdown — Performs a graceful shutdown of the server.
PAGE 81
iDRAC needs to support graceful shutdown The support of address individual blades is expected on the CMC set Description Imports the saved CMC Event Filter configuration from a file. NOTE: Currently, these commands are supported only in remote RACADM. Synopsis racadm set -f Input • –f: Configure event filter configurations from a configuration file. Example • –Configure event filter configurations from a configuration file. racadm -r 10.94.161.119 -u root -p calvin set -f config.
PAGE 82
setflexaddr Description Enables or disables FlexAddress on a particular slot or fabric. To use this subcommand, you must have the Chassis Configuration Administrator privilege. If the fabric type is determined to be Infiniband, the operation is canceled and the command returns an error. If the FlexAddress feature is not activated, the command returns an error. NOTE: The server must be turned off to change the slot state. All servers must be turned off to change the fabric state.
PAGE 83
– 0 — no blinking – 1 — blinking Example • racadm setled -m server-1 -1 1 LED state was set successfully. NOTE: The setled command generates an error when used on the extension slot of a multi-slot server. • 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.
PAGE 84
setpciecfg Description Configure PCIe slots and Virtual Adapters. NOTE: To use this subcommand, you must have Chassis Administrator privilege. NOTE: The slot assignment feature is licensed. Synopsis racadm setpciecfg assign [-c ] [-i ] racadm setpciecfg unassign [-c ] Input • • • -c — Use this option to specify a PCIe adapter or Virtual Adapter. -I — Use this option to specify the slot number. FQDD — FQDD of the specified PCIe slot or Virtual Adapter.
PAGE 85
— off is the offset in minutes NOTE: 'Off' is the offset in minutes from GMT and must be in 15-minute increments. The timezone is represented as an offset from GMT, and the clock does not automatically adjust to daylight savings time (for the '-d' option). • -z - Sets the time zone by name or index, or lists possible time zones. For example, PST8PDT (Western United States), 294 (Seoul), 344 (Sydney). may be: — lists the major timezone names/prefixes.
PAGE 86
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 more information, see the Dell OpenManage Server Administrator User's Guide at support.dell.com/manuals. Synopsis racadm setslotname [-i | -h 0|1] racadm setslotname -h Input • • • — Specify the slot number in the chassis. Valid values: 1 to 4. — The new name to be assigned to the slot.
PAGE 87
sshpkauth Description Enables you to upload and manage up to four different SSH public keys per user. You can upload a key file or key text, view keys, or delete keys. This command has three mutually exclusive modes— upload, view, and delete that are determined by the options. Upload The upload mode allows you to upload a keyfile or to copy the key text on the command line. You cannot upload and copy a key at the same time.
PAGE 88
• -d - Delete the key for the index provided. Examples : • 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.
PAGE 89
sslcertupload Description Uploads a custom SSL server or CA certificate for Directory Service from the client to iDRAC. To use this subcommand, you must have the Configure iDRAC permission. Synopsis racadm sslcertupload -t [-f ] Input • • • • -t — Specifies the type of certificate to upload, either the CA certificate for Directory Service or the server certificate. — 1 = server certificate.
PAGE 90
Serial Number 00 Subject Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU) Remote Access Group Common Name (CN) iDRAC Default certificate Issuer Information: Country Code (CC) US State (S) Texas Locality (L) Round Rock Organization (O) Dell Inc.
PAGE 91
racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate Jul 8 16:21:56 2005 GMT Jul 7 16:21:56 2010 GMT sslcsrgen Description Generates and downloads a CSR file to the client’s local file system. The CSR can be used for creating a custom SSL certificate that can be used for SSL transactions on iDRAC. To use this subcommand, you must have the Configure iDRAC permission.
PAGE 92
• Example CSR does not exist. racadm sslcsrgen -s or racadm sslcsrgen -g -f c:\csr \csrtest.txt NOTE: Before a CSR can be generated, the CSR fields must be configured in the RACADM cfgRacSecurity group. For example: racadm config -g cfgRacSecurity -o cfgRacSecCsrCommonName MyCompany NOTE: In telnet/ssh console, you can only generate and not download the CSR file. sslresetcfg Description Restores the web-server certificate to factory default and restarts web-server.
PAGE 93
• Make sure that the SMTP IP address is configured properly — racadm config -g cfgRemoteHosts -o cfgRhostsSmtpServerIpAddr 192.168.0.152 • View the current e-mail alert settings — racadm getconfig -g cfgEmailAlert -i where is a number from 1 to 4. testfeature The following tables describe the testfeature subcommand options. Option Description -f Specifies the feature name.
PAGE 94
• Checks the time to acquire user privileges with the allotted time to login. NOTE: In the event of an error, the command displays the test that failed, all the tests performed earlier to the test that failed, and all the error messages. Synopsis Example testfeature -f ad -u -p [-d ] • • • testfeature –f ad –u user@domain –p secret SUCCESSFUL: User permissions are xxxxxppp. The last three digits are the user's permissions.
PAGE 95
NOTE: In the event of an error, the command outputs all tests performed up to and including the test that failed, and all the error messages. Synopsis testfeature -f adkrb -u [-d ] testfeature -f ldap Description Tests LDAP configuration and operation, and reports success as each stage of the authentication process proceeds. After successful completion, this command prints the CMC privileges assumed by the specified .
PAGE 96
To use this subcommand, you must have the Administrator permission. Synopsis racadm traceroute racadm traceroute 192.168.0.1 Input racadm traceroute 192.168.0.1 Output traceroute to 192.168.0.1 (192.168.0.1), 30 hops max, 40 byte packets 1 192.168.0.1 (192.168.0.1) 0.801 ms 0.246 ms 0.253 ms traceroute6 Description Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv6 address.
PAGE 97
CMC Property Database Group and Object Descriptions 3 The CMC property database contains the configuration information for CMC. Data is organized by associated object, and objects are organized by object group. The IDs for the groups and objects that the property database supports are listed in this section for CMC. Use the group and object IDs with the RACADM subcommands to configure CMC. NOTE: You can configure any setting that is not preceded by the hash sign (#) in the output.
PAGE 98
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. Default for CMC The current CMC firmware build version. idRacName (Read Only) Description A user-assigned name to identify this controller.
PAGE 99
property is only valid if cfgNicVLanEnable is set to 1 (enabled). Legal Values 1 – 4000 and 4021 – 4094 Default 1 Example racadm config -g cfgLanNetworking -o cfgNicVlanID 1 cfgDNSDomainNameFromDHCP (Read/Write) Description Legal Values Default Specifies that the DNS domain name should be assigned from the network DHCP server. • • 1 (TRUE) 0 (FALSE) 0 This property is used only if cfgNicUseDhcp is set to 1 (true), or if both cfgIPv6Enable and cfgIPv6AutoConfig are set to 1 (true).
PAGE 100
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. NOTE: Some DNS servers only register names of 31 characters or fewer. Default cmc- cfgDNSRegisterRac (Read/Write) Description Legal Values Default Registers the CMC name on the DNS server.
PAGE 101
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.
PAGE 102
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. Default 0.0.0.0 cfgNicEnable (Read/Write) Description Enables or disables CMC network interface controller.
PAGE 103
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). Legal Values String representing a valid gateway IPv4 address. For example: 192.168.0.1. Default 192.168.0.
PAGE 104
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:). Legal Values A string with a maximum length of 255 ASCII characters. Default cfgRhostsSmtpServerIpAddr (Read/Write) Description The IPv4 or IPv6 address of the network SMTP server.
PAGE 105
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 aid in NTP configuration.
PAGE 106
cfgRhostsSyslogServer2 (Read/Write) Description Specifies the second 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. Default cfgRhostsSyslogServer3 (Read/Write) Description Specifies the third 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).
PAGE 107
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. Up to 16 instances of the user group are allowed. Each instance represents the configuration for an individual user.
PAGE 108
iDRAC Specific User Privilege Privilege Bit Mask Login to iDRAC 0x00000001 Configure iDRAC 0x00000002 Configure Users 0x00000004 Clear Logs 0x00000008 Execute Server Control Commands 0x00000010 Access Virtual Console 0x00000020 Access Virtual Media 0x00000040 Test Alerts 0x00000080 Execute Debug Commands 0x00000100 CMC Specific User Privilege CMC Login User 0x0000001 Chassis Configuration Administrator 0x0000002 User Configuration Administrator 0x0000004 Clear Logs Administrator 0
PAGE 109
string cannot contain / (forward slash), \ (backslash), . (period), @ (at symbol) or quotation marks. NOTE: This property value must be unique among user names. Legal Values A string of up to 16 ASCII characters. Default • • root (User 2) (All others) cfgUserAdminPassword (Write Only) Description The password for this user. User passwords are encrypted and cannot be seen or displayed after the property is written. Legal Values A string of up to 20 ASCII characters.
PAGE 110
cfgEmailAlertEnable (Read/Write) Description Enables or disables the alert instance. Legal Values • • Default 1 (TRUE) 0 (FALSE) 0 cfgEmailAlertAddress (Read/Write) Description Specifies the destination email address for email alerts, for example, user1@company.com. Legal Values E-mail address format, with a maximum length of 64 ASCII characters. Default cfgEmailAlertEmailName Description Specifies name or other identifier associated with the destination e-mail address.
PAGE 111
Example racadm getconfig -g cfgSessionManagement cfgSsnMgtWebserverTimeout=0 cfgSsnMgtTelnetIdleTimeout=0 cfgSsnMgtSshIdleTimeout=300 cfgSsnMgtRacadmTimeout=0 cfgSsnMgtWebserverTimeout (Read/Write) Description Defines the Web server time-out. This property sets the amount of time (in seconds) that a connection is allowed to remain idle (there is no user input). The session is cancelled if the time limit set by this property is reached. Changes to this setting do not affect the current session.
PAGE 112
• Default 60 – 1920 1800 cfgSerialConsoleNoAuth (Read/Write) Description Legal Values Default Enables or disables the RAC or CMC serial console login authentication. • • 0 (enables serial login authentication) 1 (disables serial login authentication) 0 cfgSerialConsoleCommand (Read/Write) Description Specifies a serial command that is executed after a user logs into the serial console interface. Legal Values A string representing a valid serial command. For example, connect server-1.
PAGE 113
• Default 0 (FALSE) 1 Example racadm getconfig -g cfgSerial cfgSerialBaudRate=115200 cfgSerialConsoleEnable=1 cfgSerialConsoleQuitKey=^\ cfgSerialConsoleIdleTimeout=1800 cfgSerialConsoleNoAuth=0 cfgSerialConsoleCommand= cfgSerialConsoleColumns=0 cfgSerialHistorySize=8192 cfgSerialTelnetEnable=0 cfgSerialSshEnable=1 cfgSerialTelnetEnable (Read/Write) Description Legal Values Default Enables or disables the Telnet console interface on CMC.
PAGE 114
Example racadm getconfig -g cfgOobSnmp cfgOobSnmpTrapsEnable=1 cfgOobSnmpAgentCommunity=public cfgOobSnmpAgentEnable (Read/Write) Description Legal Values Default Enables or disables the SNMP agent. • • 1 (TRUE) 0 (FALSE) 0 cfgTraps This group displays information for and configures delivery of SNMP traps for a specific user. This object property is applicable only to CMC. Use this object with the config or getconfig subcommands.
PAGE 115
cfgTrapsCommunityName Description Sets the community string (identical to the community name) used for authentication. The community string acts as a password shared between different hosts over the network. This community string value must match with that of the other hosts for any kind of communication through SNMP. Legal Values A string representing the community name.
PAGE 116
cfgRacTuneHttpPort (Read/Write) Description Specifies the port number to use for HTTP network communication. Legal Values 10–65535 NOTE: The following port numbers are reserved and cannot be used: 21, 68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106. Default 80 cfgRacTuneHttpsPort (Read/Write) Description Specifies the port number to use for HTTPS network communication with.
PAGE 117
cfgRacTuneIpRangeMask (Read/Write) Description Standard IP mask values with left-justified bits. For example, 255.255.255.0. A login from the incoming IP address is allowed only if both of the following are identical: • • cfgRacTuneIpRangeMask bit-wise and with incoming IP address cfgRacTuneIpRanbeMask bit-wise and with cfgRacTuneIpRangeAddr. Legal Values An IPv4 address formatted string, for example, 255.255.255.0. Default 255.255.255.
PAGE 118
cfgRacTuneSshPort (Read/Write) Description Specifies the port number used for the SSH interface. Legal Values 10–65535 Default 22 cfgRacTuneTelnetPort (Read/Write) Description Specifies the port number used for iDRAC or CMC Telnet interface. NOTE: For CMC, the following port numbers are reserved and cannot be used: 21, 68, 69, 123, 161, 546, 801, 4096, 5988, 5989, 6900, 9000, 60106.
PAGE 119
cfgRacTuneTimezoneOffset (Read Only) Description Specifies the time zone offset (in minutes) from Greenwich Mean Time (GMT)/Coordinated Universal Time (UTC) to use for the RAC Time. Some common time zone offsets for time zones in the United States are: • • • • –480 (PST—Pacific Standard Time) –420 (MST—Mountain Standard Time) –360 (CST—Central Standard Time) –300 (EST—Eastern Standard Time) For CMC: This object property is read only. Specifies the difference in number of seconds, from the UTC/GMT.
PAGE 120
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 The following sections provide information about the objects in the cfgServerInfo group. cfgServerInfoIndex (Read Only) Description Displays the index name of the server. Legal Values None Default None cfgServerSlotNumber (Read Only) Description Specifies the location of the specified server (1–4) in the chassis.
PAGE 121
cfgServerBmcMacAddress (Read Only) Description Displays the BMC MAC address of the specified server. Legal Values None Default None cfgServerNic1MacAddress (Read Only) Description Displays the MAC address of the server NIC 1. Legal Values None Default None cfgServerNic2MacAddress (Read Only) Description Displays the MAC address of the server NIC 2. Legal Values None Default None cfgServerNic3MacAddress (Read Only) Description Displays the MAC address of the server NIC 3.
PAGE 122
• Default 0 (Disable) None cfgServerIPMIOverLanEnable (Read/Write) Description Enables or disables IPMI LAN channel. Legal Values • • Default 1 (enable) 0 (disable) None cfgServerPowerBudgetAllocation (Read Only) Description Displays the current power allocation for the server. Legal Values • • Default 1 (Enable) 0 (Disable) None cfgServerDNSRegisterIMC (Read/Write) Description Enables or disables DNS name registration for the Integrated System (iDRAC).
PAGE 123
cfgServerFirstBootDevice (Read/Write) Description Sets or displays the first boot device. This object is read-write. NOTE: For a vFlash Partition to be configured as First Boot Device, it has to be attached first.
PAGE 124
cfgServerName=SLOT-08 # cfgServerFW=3.
PAGE 125
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. The following sections provide information about the objects in the cfgActiveDirectory group. cfgADRacName (Read/Write) Description Name of CMC as recorded in the Active Directory forest. Legal Values Any printable text string of up to 254 characters, with no white space.
PAGE 126
cfgADAuthTimeout (Read/Write) Description Specifies the number of seconds to wait for Active Directory authentication requests to complete before timing out. NOTE: To modify this property, you must have the Configure CMC permission. Legal Values 15–300 seconds Default 120 cfgADSCLEnable Description Legal Values Default Enables you to log on to the CMC without enabling the Smart Card login.
PAGE 127
cfgADDomainController2 (Read/Write) Description Specifies the LDAP server from which you want the CMC to obtain user names . Legal Values A string of up to 254 ASCII characters representing a valid IP address or a fully qualified domain name (FQDN). Default None cfgADDomainController3 (Read/Write) Description Specifies the LDAP server from which you want the CMC to obtain user names .
PAGE 128
• Default 2 (Enables Active Directory with the standard schema) 1 cfgADDcSRVLookupbyUserdomain (Read/Write) Description Legal Values Chooses the way the user domain is looked up for Active Directory. • • Default 1 (TRUE)—use user domain as the search domain to look up DCs. The user domain is chosen from the user domain list or entered by the login user. 0 (FALSE)—use the configured search domain cfgADDcSrvLookupDomainName to look up DCs.
PAGE 129
uses the values cfgAdGlobalCatalog1, cfgAdGlobalCatalog2, and cfgAdGlobalCatalog3. Legal Values • • Default 0(FALSE)—use pre‑configured Global Catalog Servers (GCS) 1(TRUE)—use DNS to look up GCS 0 cfgADSpecifyServerEnable Description Legal Values Default 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.
PAGE 130
NOTE: You can specify multiple servers by separating each server with a comma. For example, example.com, sub1.example.com Legal Values String. Maximum length = 254 Default Null cfgLdapPort (Read/Write) Description Port of LDAP over SSL. Non-SSL port is not supported. Legal Values 1 - 65535 Default 636 cfgLdapBasedn (Read/Write) Description The Domain Name of the branch of the directory where all searches should start from. Legal Values String.
PAGE 131
• Default 0 (FALSE)—Use the userDN provided by the login user 1 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. Legal Values String.
PAGE 132
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. The string must begin with a letter.
PAGE 133
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) • cfgLDAPRoleGroupPrivilege: a CMC privilege map Each LDAP–authenticated user assumes the total set of CMC privileges assigned to the matching LDAP distinguished names that the user belongs to. That is, if the user belongs to multiple role group DNs, the user receives all associated privileges for those DNs.
PAGE 134
cfgLocationAisle (Read/Write) Description Indicates aisle where server is located. Legal Values String of up to 128 ASCII characters Default 0 cfgLocationRack (Read/Write) Description Indicates rack where server is located. Legal Values String of up to 128 ASCII characters Default 0 cfgLocationRackslot (Read/Write) Description Indicates the slot where a server is located.
PAGE 135
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 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.
PAGE 136
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. To modify a configurable object, use the -o option. The following sections provide information about the objects in the cfgChassisPower group. cfgChassisExternalPowerManagementMode Description Allows to enable or disable External Power Management.
PAGE 137
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 None cfgChassisMinPowerTimestamp (Read Only) Description The timestamp recorded when the minimum system power occurred. Legal Values None Default None cfgChassisPowerStatus (Read Only) Description Legal Values Default Indicates the power status of the chassis.
PAGE 138
cfgChassisPowerCapF (Read/Write) Description Indicates the maximum power consumption limit (in Watt) for the entire chassis. Use cfgChassisPowerCapF when power consumption is to be changed regardless of whether server throttling is required. This command generates an error if the value for this setting is lower than the minimum power required for the chassis configuration.
PAGE 139
cfgChassisRedundancyPolicy (Read/Write) Description Sets the redundancy policy of the chassis. Legal Values • • • Default 0 (no redundancy) 1 (AC redundancy) 2 (power supply redundancy) 0 (no redundancy) cfgChassisDynamicPSUEngagementEnable (Read/Write) Description Enables or disables dynamic engagement.
PAGE 140
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.
PAGE 141
cfgChassisPowerButtonEnable (Read/Write) Description Indicates if the chassis power button is enabled or disabled. Legal Values • • Default 0 (disabled) 1 (enabled) 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.
PAGE 142
• • 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.
PAGE 143
cfgAlertingEnable Description Legal Values Default Enables or disables event traps on the CMC. • • 1 (true) 0 (false) None cfgAlertingSourceEmailName Description Specifies the e-mail address used to send e-mail notifications when an event occurs. Legal Values None Default None Examples racadm getconfig -g cfgAlerting -o cfgAlertingSourceEmailName racadm config -g cfgAlerting -o cfgAlertingSourceEmailName user@home.com Object value modified successfully.
PAGE 144
cfgLcdOrientation Read or Write Description Set the viewing angle of the LCD based on the orientation of the chassis (Tower or Rack). Legal Values • • Default 0 0 for Tower 1 for Rack cfgIPv6LanNetworking This group is used to configure the IPv6 over LAN networking capabilities. Use this object with the config or getconfig subcommands. To use this object property for CMC, you must have the Chassis Configuration Administrator privilege.
PAGE 145
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 Specifies the prefix length for IPv6 address. NOTE: This property is used only if cfgIPv6AutoConfig is set to 0 (false) Legal Values 0–128 Default 64 cfgIPv6AutoConfig (Read/Write) Description Enables or disables the IPv6 Auto Configuration option.
PAGE 146
NOTE: This property is used only if cfgIPv6DNSServersFromDHCP6 is set to 0 (false). Legal Values A string representing a valid IPv6 entry. For example, 2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF Default :: cfgIPv6DNSServer2 (Read/Write) Description Specifies the IPv6 DNS server address. NOTE: This property is only valid if cfgIPv6DNSServersFromDHCP6 is set to 0 (false). Legal Values A string representing a valid IPv6 entry.
PAGE 147
cfgNicCurrentIpAddress Description Displays the static IP address to the CMC. Legal Values Default cfgNicCurrentNetmask Description Displays the static subnet mask for the CMC IP address. Legal Values Default cfgNicCurrentGateway Displays the static gateway for the CMC IP address. Description Displays the static gateway for the CMC IP address. Legal Values Default cfgNicCurrentDhcpWasUsed Description Indicates whether DHCP is used to configure the NIC. Legal Values 0 – address is static.
PAGE 148
cfgNicCurrentVlanPriority (Read Only) Description Indicates the Current Virtual Lan Priority. Legal Values Integer Default None cfgCurrentLinkLocalAddress Description Displays the current IPv6 link-local address of the CMC. Legal Values Default cfgDNSCurrentServer1 Description Displays the IP address for DNS server 1. Legal Values A Valid IPv4 DNS IP Default None cfgDNSCurrentServer2 Description Displays the IP address for DNS server 2.
PAGE 149
# # # # # # cfgNicCurrentVlanEnable=0 cfgNicCurrentVlanID=1 cfgNicCurrentVlanPriority=0 cfgDNSCurrentServer1=192.168.0.5 cfgDNSCurrentServer2=192.168.0.6 cfgDNSCurrentDomainName=MYDOMAIN cfgCurrentIPv6LanNetworking (Read Only) This group displays the current CMC IPv6 properties. Use this object with the getconfig subcommand. To use this object property, you must have the CMC Login User privilege. cfgCurrentIPv6Enabled Description Indicates whether IPv6 is enabled on the CMC.
PAGE 150
cfgCurrentIPv6Gateway Description Displays the current IPv6 gateway. Legal Values Default cfgCurrentIPv6DNSServersFromDHCP6 Description Indicates whether the DNS server addresses are assigned from the DHCPv6 server. Legal Values Default cfgCurrentIPv6DNSServer1 Description Displays the IPv6 address for DNS server 1. Legal Values Default cfgCurrentIPv6DNSServer2 Description Displays the IPv6 address for DNS server 2.
PAGE 151
cfgNetTuningNicSpeed Description Specifies the speed for the CMC NIC. This property is used only if cfgNetTuningNicAutoNeg is set to 0. Legal Values 10, 100, or 1000 Default 100 cfgNetTuningNicAutoneg (Read/Write) Description Legal Values Default Enables autonegotiation of physical link speed and duplex. If enabled, autonegotiation takes priority over other values set in this group.
PAGE 152
cfgNetTuningNicMtu (Read/Write) Description The size in bytes of the maximum transmission unit used by CMC NIC. Legal Values 576 – 1500 Default 1500 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. cfgRacSecurity This group is used to configure settings related to CMC SSL certificate signing request (CSR) feature. The properties in this group must be configured before generating a CSR from CMC.
PAGE 153
cfgRacSecCsrStateName (Read/Write) Description Specifies the CSR State Name (S). Legal Values A string of up to 254 characters. Default cfgRacSecCsrCountryCode (Read/Write) Description Specifies the CSR Country Code (CC). Legal Values A string of 2 alphabet country code. Default US cfgRacSecCsrEmailAddr (Read/Write) Description Specifies the CSR email address. Legal Values A string of up to 254 characters.