Reference Guide

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

Chassis Management Controller Version 1.30 for Dell

PowerEdge VRTX RACADM Command Line Reference

Guide

Summary of content (152 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. Copyright © 2014 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
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
init.....................................................................................................................................................................75 raid................................................................................................................................................................... 76 raid...................................................................................................................................................................
PAGE 6
cfgDNSServersFromDHCP (Read/Write)....................................................................................................... 100 cfgDNSServer1 (Read/Write).........................................................................................................................100 cfgDNSServer2 (Read/Write).........................................................................................................................100 cfgNicEnable (Read/Write)...........................................
PAGE 7
cfgSerialConsoleIdleTimeout (Read/Write)................................................................................................... 110 cfgSerialConsoleNoAuth (Read/Write).......................................................................................................... 111 cfgSerialConsoleCommand (Read/Write)...................................................................................................... 111 cfgSerialConsoleColumns........................................................
PAGE 8
cfgServerNic3MacAddress (Read Only)........................................................................................................120 cfgServerNic4MacAddress (Read Only)........................................................................................................120 cfgServerPriority (Read/Write)...................................................................................................................... 120 cfgServerNicEnable (Read/Write)..........................................
PAGE 9
cfgLDAPBinddn (Read/Write)........................................................................................................................ 129 cfgLDAPBindpassword (Write Only)..............................................................................................................130 cfgLDAPSearchFilter (Read/Write)................................................................................................................ 130 cfgLDAPCertValidationEnable (Read/Write)..........................
PAGE 10
cfgChassisMaxPowerConservationMode (Read/Write)................................................................................138 cfgChassisInMaxPowerCapacity (Read Only)............................................................................................... 138 cfgChassisInRedundancyReserve (Read Only)..............................................................................................138 cfgChassisInPowerServerAllocation (Read Only).........................................................
PAGE 11
cfgDNSCurrentServer2.................................................................................................................................. 147 cfgDNSCurrentDomainName.........................................................................................................................147 cfgCurrentIPv6LanNetworking (Read Only)..........................................................................................................147 cfgCurrentIPv6Enabled.......................................
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 traceroute6 CMC 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 the CMC Login User privilege. Synopsis racadm getpciecfg [-c ][a] 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. -r — Use this option to view the ride-through configuration settings.
PAGE 48
A 8 A Empty N/A N/A N/A Unmapped N/ 9 1 SLOT-01 1 Present 9 2 SLOT-02 2 Not Present 9 3 SLOT-03 3 Present 9 4 Unmapped N/ A N/A 10 1 10 2 10 3 10 A 1 2 3 4 N/A SLOT-01 Present SLOT-02 Not Present SLOT-03 Present Unmapped • Displays the properties of a PCIe slot selected using FQDD: racadm getpciecfg -c pcie.chassisslot.
PAGE 49
Minimum System Power Timestamp 06:32:55 01/26/2009 System Idle Power (188 BTU/hr) System Potential Power (188 BTU/hr) System Input Current Reading A = = 68 W = 68 W = 31.2 [Real-Time Energy Statistics] System Energy Consumption = 6.
PAGE 50
• --more — Displays one screen at a time and prompts the user to continue. Output The default output display shows the record number, message ID, category, agent ID, severity, time stamp, message arg, and message. The timestamp begins at midnight, January 1, and increases until the system restarts. After the system restarts, the system’s timestamp is used.
PAGE 51
Example racadm getredundancymode Redundant getsel Description Synopsis Displays all sensor event log entries in the DRAC. • • racadm getsel -i [-A] racadm getsel [-s ] [-c ] [-A] [-o] [-E] [-R] [--more] If no arguments are specified, the entire log is displayed. Input • • • • • • • • -A — Specifies output with no display headers or labels. -c — Provides the number of records to be displayed. -o — Displays each entry in the SEL in a single line.
PAGE 52
Fan-2 OK 0 840 600 N/A N/A Fan-3 OK 4037 840 600 N/A N/A Fan-4 OK 4045 840 600 N/A N/A Fan-5 OK 4107 840 600 N/A N/A Fan-6 OK 0 840 600 N/A N/A Blower-1 N/A 0 3000 2250 N/A N/A Blower-2 N/A 0 3000 2250 N/A N/A Blower-3 N/A 0 3000 2250 N/A N/A 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
PAGE 53
Input • racadm getslotname -h • None Displays the slot name for all the four slots in the chassis. -i - specifies the slot number. Values: 1 to 4 -h - Specifies whether to display the slot name or the host name (if available). 1 displays host names and 0 displays slot names. • • Example • Display all slots names. racadm getslotname 1 SLOT-01 2 Webserver01 3 Webserver3 4 SLOT-04 WXP-8GRB221 WXP-319QWEecet5 • Display the name of the third slot.
PAGE 54
racadm getssninfo -A -u * "root" "143.166.174.19" "Telnet" "NONE" "bob" "143.166.174.19" "GUI" "NONE" getsvctag Description Displays the service tag of the host system. Synopsis racadm getsvctag Input getsvctag Output Chassis Switch-1 Server-1 Server-2 Server-3 Server-4 Example racadm getsvctag PLPC033 N/A 7654321 N/A Extension(1) PLSMS04 getsysinfo Description Displays information related to CMC and chassis.
PAGE 55
Examples VLAN Enabled = 0 CMC IPv4 Information: IPv4 Enabled Current IP Address Current IP Gateway Current IP Netmask DHCP Enabled Current DNS Server 1 Current DNS Server 2 DNS Servers from DHCP = = = = = = = = 1 10.94.237.30 10.94.237.1 255.255.255.128 1 10.94.175.2 0.0.0.
PAGE 56
NOTE: The -A and -o options are deprecated. Output The default output display shows the record number, timestamp, source, and description. The timestamp begins at midnight, January 1 and increases until the system boots. After the system boots, the system’s timestamp is used. Example Record: 1 Date/Time: Dec Source: ssnmgrd[175] 8 08:21:30 Description: root from 143.166.157.
PAGE 57
• • • -l - Displays the firmware versions Lifecycle Controller components. -f - Filters the components. Must be used with -1 and be one of the following values: – bios: BIOS – idrac: iDRAC – usc: Unified Server Configurator (Lifecycle Controller) – diag: 32-bit Diagnostics – drivers: OS Driver Package – nic-x: Network Interface card. See -l output for possible values of x. – raid-x: RIAD Controller. See -l output for possible values of x.
PAGE 58
Example $ racadm ifconfig eth0 Link encap:Ethernet 00:1D:09:FF:DA:23 HWaddr inet addr:10.35.155.136 Bcast:10.35.155.255 Mask:255.255.255.0 MULTICAST Metric:1 UP BROADCAST RUNNING MTU:1500 RX packets:2550665 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 1000 (259.9 MiB) (0.0 B) collisions:0 txqueuelen: RX bytes:272532097 TX bytes:0 jobqueue Description Displays the jobs in that are currently being run, delete the jobs, and create a job.
PAGE 59
Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] --------------------------------------------------------[Job ID=RID_852218430518] Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] --------------------------------------------------------[Job ID=RID_852215634901] Job Name=Reboot4 Status=New Start Time=[NOW] Expiration Time=[NOW] --------------------------------------------------------[Job ID=JID_852215394003] Job Name=ConfigRAID:GUI:RAID.ChassisIntegrated.
PAGE 60
license Description Manages the CMC licenses. Synopsis racadm license .
PAGE 61
NOTE: During export, the license file is named _.xml. Examples • • • • -u— User name of the remote share. -p — Password for the remote share. -e — Specifies the entitlement ID of the license file. -t — Specifies the transaction ID of the license file. • View licenses: – View all the license information in the chassis. racadm license view CMC.Integrated.1 Status = OK Device = CMC.Integrated.
PAGE 62
Therefore, if a file name is provided, an index is appended to the end of the file name such as LicenseFile0.xml, LicenseFile1.xml, and so on. In this case, the device is an embedded CMC: racadm license export -u root -p calvin -f LicenseFile.xml -l //192.168.2.140/licshare -c cmc.embedded.1 • • Delete a license: – Delete licenses on a particular device. For example. Embedded CMC: racadm license delete -c cmc.embedded.1 – Delete license using an entitlement ID.
PAGE 63
U 256 0 0 eth1 Kernel IP routing table Destination Gateway Genmask Flags MSS Window irtt Iface 10.94.161.0 0.0.0.0 255.255.255.0 U 0 0 0 bond0 0.0.0.0 10.94.161.1 0.0.0.0 UG 0 0 0 bond0 Active Internet connections (w/o servers) Proto Recv-Q Send-Q Local Address Foreign Address State tcp 0 0 127.0.0.1:8195 127.0.0.1:52887 ESTABLISHED tcp 0 0 127.0.0.1:199 127.0.0.1:52174 ESTABLISHED tcp 0 0 127.0.0.1:52175 127.0.0.1:199 ESTABLISHED tcp 0 0 127.0.0.1:199 127.0.0.1:52175 ESTABLISHED tcp 0 0 10.94.161.
PAGE 64
echo packet is sent to the destination IPv6 address on the basis of current routing-table contents. To use this subcommand for CMC, you must have the Administrator privilege. Synopsis racadm ping6 Example racadm iping6 10.9.72.254 IPING6 10.9.72.254 (10.9.72.254): 56 data bytes 64 bytes from 10.9.72.254: icmp_seq=0 ttl=121 time=2.9 ms --- 10.9.72.254 ping statistics --1 packets transmitted, 1 packets received, 0 percent packet loss round-trip min/avg/max = 2.9/2.9/2.
PAGE 65
Output The following information is displayed when the racdumpsubcommand is processed: • • • • • General system/RAC information Coredump Session information Process information Firmware build information racreset Description Performs a CMC or a RAC reset operation. 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.
PAGE 66
– – – pcap — Reset Power Cap properties to the default value. flex — Reset FlexAddress properties to the default value. The default setting is “enabled”. dpse — Reset Dynamic Power Supply Engagement to the default value. The default setting is “disabled”. NOTE: The –c option is valid with only . Example • Perform reset of configuration data to defaults for server-1 module racadm racresetcfg -m server-1 • Perform reset of power cap feature.
PAGE 67
This command displays all battery keys connected to the controllers referred to as refkeys. racadm raid get batteries --refkey -o This command is an optimized version and displays all battery objects for the controller FQDD. racadm raid get batteries --refkey -o -p This command is an optimized and filtered version.
PAGE 68
This command displays all fan objects for the enclosure FQDD. racadm raid get fans --refkey -o -p optimized and filtered version. • Monitor and Inventory all EMMs connected to the enclosure racadm raid get emms --refkey This command will return all EMM keys connected to the enclosures being mentioned as refkeys.
PAGE 69
Example racadm raid blink:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 racadm raid blink:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 racadm raid blink -pdkey:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1,Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 racadm raid blink -vdkey:Disk.Virtual.0:RAID.ChassisIntegrated. 1-1,Disk.Virtual.0:RAID.ChassisIntegrated.
PAGE 70
deletevd Description Deletes the specified virtual drive. Synopsis racadm raid deletevd: {-current|-pending} Input • –current : Performs the configuration right now. NOTE: If this requires the system to reboot, it will reboot. • 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.
PAGE 71
forceonline Description Forces the RAID Controller to make the specified drive online. This operation may result in obsolete or corrupted data, and should only be attempted in cases where a rebuild operation has failed or is not applicable. Synopsis racadm raid forceonline: {current|pending} Input • • –current : Performs the configuration right now. NOTE: If this requires the system to reboot, then the system is rebooted.
PAGE 72
PciVendorId PciSubvendorId PciBus PciDevice PciFunction BusWidth SlotLength SlotType CapableSpeeds LearnMode HighAvailabilityMode PeerController = 0x1000 = 0x1028 = 0x0 = 0x0 = 0x0 = Unknown = Short = Unknown = 6.0 Gb/s, 3.0 Gb/s = Not supported = None = N/A Sample output of a CMC in which you have firmware support for the fault-tolerant mode and the hardware, and fault-tolerant mode is active, but a license is not available. RAID.ChassisIntegrated.
PAGE 73
FirmwareVersion DriverVersion RebuildRate BgiRate CheckConsistencyRate ReconstructRate PatrolReadRate PatrolReadMode PatrolReadState CheckConsistencyMode LoadBalanceSetting CopybackMode PreservedCache CacheMemorySize PersistHotspare SpindownUnconfiguredDrives SpindownHotspare Timeintervalforspindown SecurityStatus EncryptionMode SasAddress PciDeviceId PciSubdeviceId PciVendorId PciSubvendorId PciBus PciDevice PciFunction BusWidth SlotLength SlotType CapableSpeeds LearnMode HighAvailabilityMode PeerControlle
PAGE 74
racadm raid hotspare:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 -assign yes -type ghs racadm raid hotspare:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 -assign yes -type dhs vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 cancelinit Description Stops an initialization operation on the specified virtual drive. Synopsis racadm raid cancelinit: {-current | -pending} Input • –current : Immediately performs the configuration operation.
PAGE 75
• • Example NOTE: Enable cluster services on the servers when assigning Virtual Disk to multiple Virtual Adapters. –accesspolicy {na | rw}: Set the access policy to No Access or Read/Write. –vdkey:: The Virtual Drive to change the access to. racadm raid assignva:RAID.ChassisIntegrated.1-1-1 vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.1-1 -accesspolicy { na | rw } racadm raid assignva:RAID.ChassisIntegrated.1-1-2 vdkey:Disk.Virtual.0:RAID.ChassisIntegrated.
PAGE 76
raid Description Monitors, retrieves inventory, and configures the storage components connected to the chassis. NOTE: To use this subcommand, you must have the Chassis Administrator privilege.
PAGE 77
• • • • • • • • • • • • • • • • • • • • racadm raid get vdisks -o -p layout,status racadm raid get controllers:RAID.ChassisIntegrated.1-1 racadm raid get controllers:RAID.ChassisIntegrated.1-1 -p status racadm raid resetconfig:RAID.ChassisIntegrated.1-1 racadm raid exportlog:RAID.ChassisIntegrated.1-1 -l -u -p [-f ] racadm raid forceonline:Disk.Bay.0:Enclosure.Internal. 0-0:RAID.ChassisIntegrated.1-1 racadm raid deletevd:Disk.Virtual.0:RAID.
PAGE 78
To use this subcommand for CMC you must have Chassis Administartor privilege. Synopsis racadm raid Example • Monitor Health of Storage root node racadm raid get status Storage Root Node Status : Ok This command retrieves the controllers keys, (FQDDs.) • Monitor and Inventory all Controllers connected to the server racadm raid get controllers racadm raid get controllers -o This command is an optimized version and displays the full controller objects along with their keys.
PAGE 79
This command displays all enclosure objects for the connector FQDD. racadm raid get enclosures --refkey -o -p • This command is an optimized and filtered version. Monitor and Inventory all Physical Disks connected to the enclosure /Backplanes racadm raid get pdisks --refkey This command displays all physical disk keys connected to the enclosures being mentioned as refkeys.
PAGE 80
This command displays all power supply units connected to the enclosures being mentioned as refkeys. racadm raid get psus --refkey -o This command is an optimized version and displays all power supply units objects for the enclosure FQDD. racadm raid get psus --refkey -o -p This command is an optimized and filtered version. rebuild Description Starts a rebuild on a specified virtual drive.
PAGE 81
Example • • • -p - Password to access the network share. -l - Image location on the network share; use double quotation marks with a location. -s - Display current status; –a is assumed, if not specified. • racadm remoteimage -c -u "user" -p "pass" -l //shrloc/ foo.iso • Remote Image is now Configured racadm remoteimage -d - disconnect • Disable Remote File Started. Please check status using -s option to know Remote File Share is ENABLED or DISABLED.
PAGE 82
• Turn off server 3 from iDRAC racadm serveraction powerdown • Server power operation successful Turn off server 3 from CMC when Power is already Off on that server racadm serveraction -m server-3 powerdown • Server is already powered OFF. Turn off the server from iDRAC when Power is already off on that server.
PAGE 83
You can obtain the same output if you do not include this option, because there is only one legal value. is a maximum of 64 non-extended ASCII characters. Example • racadm setassettag -m chassis 783839–33 • racadm setassettag 783839–33 The asset tag was changed successfully. setchassisname Description Sets the name of the chassis in the LCD. To use this subcommand, you must have the Administrator privilege.
PAGE 84
• racadm setflexaddr -f A 1 Fabric A FlexAddress state set successfully • racadm setflexaddr -f idrac 1 setled Description Sets the state (blinking or not blinking) of the LED on the specified module. To blink or unblink the chassis, I/O modules or the CMC, you must have the Debug Administrator privilege on CMC. To enable the servers to blink or unblink, you must have the Server Administrator or Debug Administrator privilege on CMC.
PAGE 85
Input • racadm setniccfg -s6 • racadm setniccfg -o • • • -d — Enables DHCP for the NIC (default is “DHCP disabled”.) -d6 — Enables AutoConfig for the NIC. It is enabled by default. -s — Enables static IP settings. The IPv4 address, netmask, and gateway can be specified. Otherwise, the existing static settings are used. , , and must be typed as dot-separated strings. racadm setniccfg -s 192.168.0.120 255.255.255.0 192.
PAGE 86
• Unassign a PCIe slot: racadm setpciecfg unassign -c PCIE.ChassisSlot.3 • Unassign a Virtual Adapter: racadm setpciecfg unassign -c RAID.ChassisIntegrated.1-1-3 • Enable ride-through mode racadm setpciecfg ridethru -e IOV000: Successfully completed the operation. • Disable ride-through mode racadm setpciecfg ridethru -d IOV000: Successfully completed the operation.
PAGE 87
— is the case-sensitive name of your timezone or the index listed by '-z timezone-prefix*'. — is a prefix of one or more timezones, followed by '*'. NOTE: The timezone or daylight savings time is fully supported for '-l' and '-z' options. Omit the '-l' option to set the timezone only (eg. '-z US/Central').
PAGE 88
Example • — Sets whether the server's host name is used for display purposes. Valid values: 0 or 1. • Set the name of slot 3 as server3: racadm setslotname -i 3 server3 • Enable system to display host names (1=Active): racadm setslotname -h 1 setsysinfo Description Sets the name or location of the chassis. To use this subcommand, you must have the Administrator privilege.
PAGE 89
sshpkauth Description Enables you to upload and manage up to six (6) different SSH public keys. You can upload a key file or key text, view keys, or delete keys. racadm sshpkauth -i svcacct -k -p -t racadm sshpkauth -i svcacct -k -p -f racadm sshpkauth -v -i svcacct -k racadm sshpkauth -d -i svcacct -k Synopsis Input racadm sshpkauth • • • • • -i Index for the user. is the Index for CMC.
PAGE 90
• • — 1 = server certificate. — 2 = CA certificate for Directory Service — 5 = Kerberos keytab — 6 = Server certificate and key -f — Specifies the file name of the certificate to be uploaded. -k — Specifies the optional source filename for private key when uploading type 6. Output The sslcertupload command returns 0 when successful, and returns a nonzero number when unsuccessful. Example racadm sslcertupload -t 1 -f c:\cert \cert.
PAGE 91
Locality (L) Round Rock Organization (O) Dell Inc. Organizational Unit (OU) Remote Access Group Common Name (CN) iDRAC Default certificate Common Name (CN) iDRAC Default certificate Valid From Jul 8 16:21:56 2005 GMT Valid To Jul 7 16:21:56 2010 GMT racadm sslcertview -t 1 -A 00 US Texas Round Rock Dell Inc. Remote Access Group iDRAC default certificate US Texas Round Rock Dell Inc.
PAGE 92
NOTE: If the -f option is not specified, the filename defaults to sslcsr in your current directory. Output If no options are specified, a CSR is generated and downloaded to the local file system as sslcsr by default. The -g option cannot be used with the -s option, and the -f option can only be used with the -g option. The sslcsrgen -s subcommand returns one of the following status codes: • • Example CSR was generated successfully. CSR does not exist.
PAGE 93
• Enable the alert — racadm config -g cfgEmailAlert -o cfgEmailAlertEnable i 1 • Set the destination e-mail address — racadm config -g cfgEmailAlert -o cfgEmailAlertAddress i 1 user1@mycompany.com • Set the custom message that is sent to the destination e-mail address — racadm config -g cfgEmailAlert -o cfgEmailAlertCustomMsg -i 1 "This is a test!" • Make sure that the SMTP IP address is configured properly — racadm config -g cfgRemoteHosts -o cfgRhostsSmtpServerIpAddr 192.168.0.
PAGE 94
• • • • • • Verifies whether the required system resources are available. Validates Active Directory configuration. Verifies the SSL certificate and if the certificate signing request (key) exists. Acquires LDAP and Global Catalog Service records from DNS. Acquires user privileges from the Active Directory server. Checks the time to acquire user privileges with the allotted time to login.
PAGE 95
• • Acquires user privileges from the Active Directory server. Checks the time to acquire user privileges with the allotted time to login. 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.
PAGE 96
traceroute Description Traces the network path of routers that packets take as they are forwarded from your system to a destination IPv4 address. To use this subcommand, you must have the Administrator privilege. 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.
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
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. Legal Values A string of up to 15 ASCII characters. Default for CMC CMC cfgLanNetworking This group contains parameters to configure NIC for IPv4. One instance of the group is allowed.
PAGE 99
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
cfgDNSRegisterRac (Read/Write) Description Legal Values Default Registers the CMC name on the DNS server. When you set this parameter, the CMC registers its DNS name for its IPv4 and IPv6 addresses with the DNS server. • • 1 (TRUE) 0 (FALSE) 0 NOTE: For IPv6, only the DHCPv6 address or static address is registered. cfgDNSServersFromDHCP (Read/Write) Description Legal Values Default Specifies if the DNS server IPv4 addresses should be assigned from the DHCP server on the network.
PAGE 101
cfgNicEnable (Read/Write) Description Enables or disables CMC network interface controller. If the NIC is disabled, the remote network interfaces to CMC are no longer accessible and CMC are only available through the local or serial RACADM interface. Legal Values • • Default 1 (TRUE) 0 (FALSE) 1 cfgNicIpAddress (Read/Write) Description Specifies the static IPv4 address to be assigned to the RAC or CMC. NOTE: This parameter is only configurable if the cfgNicUseDhcp parameter is set to 0 (FALSE.
PAGE 102
cfgNicMacAddress (Read Only) Description The CMC NIC MAC address in the format: dd:dd:dd:dd:dd:dd, where d is a hexadecimal digit in range 0 - 9, A - F Legal Values String representing CMC NIC MAC address. Default The current MAC address of CMC NIC. For example, 00:12:67:52:51:A3. cfgRemoteHosts This group provides properties that allow configuration of the SMTP server for e-mail alerts. This group enables/disables and configures firmware updates, NTP, remote syslogging, and SMTP email alerting.
PAGE 103
cfgRhostsSmtpServerIpAddr (Read/Write) Description The IPv4 or IPv6 address of the network SMTP server. The SMTP server transmits e-mail alerts from CMC if the alerts are configured and enabled. Legal Values A string representing a valid SMTP server IPv4 or IPv6 address. For example: 192.168.0.55. Default localhost.localdomain cfgRhostsNtpEnable Description Legal Values Default Enables or disables the use of the Network Time Protocol (NTP) for date and time synchronization.
PAGE 104
cfgRhostsNtpMaxDist Description Specifies the NTP maximum distance parameter used to aid in NTP configuration. Legal Values 1–128 Default 16 cfgRhostsSyslogEnable (Read/Write) Description Legal Values Default Enables or disables remote syslog to allow the RAC and SEL logs to be written to up to three remote syslog servers. • • 1 (TRUE) 0 (FALSE) 0 cfgRhostsSyslogPort (Read/Write) Description Remote syslog port number to use for writing the RAC and SEL logs to a remote syslog server.
PAGE 105
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). Legal Values Valid hostname or IPv4 or IPv6 address. Default cfgRhostsSyslogPowerLoggingEnabled Description Enables or disables power consumption logging to remote syslog servers.
PAGE 106
NOTE: In the current CMC firmware version, the objects cfgUserAdminEnable and cfgUserAdminPrivilege are interrelated; changing the value of one property causes the value of the other property to change. For example, if a user does not have login privilege, the user is disabled by default. When you enable the user by changing the value of UserAdminEnable to 1, the right most digit of the UserAdminPrivilege also becomes 1.
PAGE 107
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 0x0000008 Chassis Control Administrator 0x0000010 Super User 0x0000020 Server Administrator 0x0000040 Test Alert User 0x0000080 Debug Command Administrator 0x0000100 Fabric A Administrator 0x0000
PAGE 108
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. Default ******** cfgUserAdminEnable (Read/Write) Description Enables or disables an individual user. NOTE: You can enable a user for a given index, only if you set the password for the same user.
PAGE 109
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. The e-mail name can refer to an individual, group, location, department, and so on.
PAGE 110
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. You must log out and log in again to make the new settings effective. An expired Web server session logs out the current session.
PAGE 111
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 112
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 113
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. To use this object property, you must have Chassis Configuration Administrator privilege.
PAGE 114
that of the other hosts for any kind of communication through SNMP. Legal Values A string representing the community name. Default None Example racadm getconfig -g cfgTraps -i 2 # cfgTrapsIndex=2 cfgTrapsEnable=1 cfgTrapsAlertDestIpAddr= cfgTrapsCommunityName=public cfgRacTuning This group is used to configure various iDRAC or CMC configuration properties, such as valid ports and security port restrictions. Use this object with the config or getconfig subcommands.
PAGE 115
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. 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.
PAGE 116
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.0 cfgRacTuneIpBlkEnable (Read/Write) Description Legal Values Default Enables or disables the IPv4 address blocking feature.
PAGE 117
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. Legal Values • • Default For iDRAC: 1 – 65535 For CMC: 10 – 65535 23 cfgRacTuneDaylightOffset (Read Only) Description Specifies the daylight savings offset (in minutes) to use for the RAC Time.
PAGE 118
For CMC: This object property is read only. Specifies the difference in number of seconds, from the UTC/GMT. This value is negative if the current time zone is west of Greenwich. Legal Values –720 to 7800 Default 0 Example racadm getconfig -g cfgRacTuning cfgRacTuneRemoteRacadmEnable=1 cfgRacTuneWebserverEnable=1 cfgRacTuneHttpPort=80 cfgRacTuneHttpsPort=443 cfgRacTuneTelnetPort=23 cfgRacTuneSshPort=22 cfgRacTuneIpRangeEnable=0 cfgRacTuneIpRangeAddr=192.168.1.1 cfgRacTuneIpRangeMask=255.255.255.
PAGE 119
Default None cfgServerSlotNumber (Read Only) Description Specifies the location of the specified server (1–4) in the chassis. Legal Values None Default None cfgServerServiceTag (Read Only) Description Displays the service tag of the specified server. Legal Values None Default None cfgServerName (Read/Write) Description Displays the name of the specified server. Legal Values Maximum of 15 non-extended ASCII characters, (ASCII codes 32–126).
PAGE 120
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. Legal Values None Default None cfgServerNic4MacAddress (Read Only) Description Displays the MAC address of the server NIC 4.
PAGE 121
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 122
NOTE: For a vFlash Partition to be configured as First Boot Device, it has to be attached first.
PAGE 123
cfgServerPriority=1 cfgServerNicEnable=1 cfgServerIPMIOverLANEnable=1 # cfgServerPowerBudgetAllocation=0 cfgServerDNSRegisterIMC=0 cfgServerDNSIMCName=iDRACcfgServerRootPassword=******** (Write-Only) cfgServerFirstBootDevice=0 # cfgServerBootOnce=1 # cfgServerPowerConsumption=0 racadm getconfig -g cfgServerInfo -i 1 # cfgServerInfoIndex=1 # cfgServerSlotNumber=1 # cfgServerServiceTag=1S0M0G1 cfgServerName=SLOT-01 # cfgServerFW=1.40 (Build 12) # cfgServerBIOS=4.0.
PAGE 124
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. Default cfgADCertValidationEnable (Read/Write) Description Enables or disables Active Directory certificate validation as a part of the Active Directory configuration process. Legal Values • • Default 1 (TRUE) 0 (FALSE) 1 cfgADRacDomain (Read/Write) Description Active Directory Domain in which CMC resides.
PAGE 125
NOTE: To modify this property, you must have the Configure CMC privilege. 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. • • 1 (Enable) 0 (Disable) 0 cfgADSSOEnable (Read/Write) Description Legal Values Default Enables or disables Active Directory single sign-on authentication on CMC.
PAGE 126
cfgADGlobalCatalog1 (Read/Write) Description Specifies the Global Catalog 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 cfgADGlobalCatalog2 (Read/Write) Description Specifies the Global Catalog server from which you want the CMC to obtain user names.
PAGE 127
cfgADDcSRVLookupDomainName (Read/Write) Description This is the Active Directory Domain to use when cfgAddcSrvLookupbyUserDomain is set to 0. Legal Values String. Maximum length = 254 Default Null cfgADDcSRVLookupEnable (Read/Write) Description Legal Values Default Configures CMC to use pre‑configured domain controllers or to use DNS to find the domain controller.
PAGE 128
cfgADDomainController or cfgADGlobalCatalog to specify the IP address. Legal Values Default • • 1 (enabled) 0 (disabled) 0 cfgLDAP This group allows you to configure settings related to the Lightweight Directory Access Protocol (LDAP). Use this object with the config or getconfig subcommands. To use this object property for CMC, you must have the Chassis Configuration Administrator privilege. NOTE: For CMC, you can configure any setting that is not preceded by the hash sign (#) in the output.
PAGE 129
Default 636 cfgLDAPBasedn (Read/Write) Description The Domain Name of the branch of the directory where all searches should start from. Legal Values String. Maximum length = 254 Default Null cfgLDAPUserAttribute (Read/Write) Description Specifies the user attribute to search for. It is recommended to be unique within the chosen baseDN, otherwise a search filter must be configured to make sure the uniqueness of the login user. If the userDN cannot be uniquely identified, login fails with error.
PAGE 130
NOTE: If cfgLDAPBindDN is [null] and cfgLDAPBindPassword is [null], then the CMC attempts an anonymous bind. Legal Values String. Maximum length = 254 Default Null cfgLDAPBindpassword (Write Only) Description A bind password to use in conjunction with the bindDN. The bind password is sensitive data, and should be protected. This is optional but is required if anonymous bind is not supported. Legal Values String.
PAGE 131
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. Default [null] cfgLDAPSRVLookupEnable Description Legal Values Default Configures the CMC to query a DNS server for SRV records. • • 1 (true) 0 (false) 0 cfgLDAPSRVLookupServiceName (Read/Write) Description Configures the service name to be used in the SRV lookup.
PAGE 132
For CMC, configure the LDAP distinguished name (DN) for the role group instance. Legal Values String. Maximum length = 1024 Default None Example racadm getconfig -g cfgLDAPRoleGroup -o cfgLDAPRoleGroupDN -i 1 cn=everyone,ou=groups,dc=openldap,dc=com cfgLDAPRoleGroupPrivilege (Read/Write) Description A bit–mask defining the privileges associated with this particular group.
PAGE 133
cfgLocationRackslot (Read/Write) Description Indicates the slot where a server is located. Legal Values Values from 1 - 255 (1 Byte) Default 0 cfgLocationDevicesize (Read Only) Description Indicates server chassis size. Legal Values Values from 1 - 255 Default 0 cfgStandardSchema This group contains parameters to configure the Active Directory standard schema settings. Use this object with thegetconfig or config subcommands.
PAGE 134
cfgSSADRoleGroupPrivilege (Read/Write) Description Use the bit mask numbers listed in the table below to set role-based authority privileges for a Role Group. Legal Values 0x00000000 0x00000fff Default Example racadm getconfig -g cfgStandardSchema -i 1 NOTE: -i is for the index.
PAGE 135
cfgChassisInPower (Read Only) Description Indicates the cumulative input power consumption data (in Watt and BTU/hr) captured from all healthy and functional PSUs in the chassis. Legal Values None Default None cfgChassisPeakPower (Read Only) Description Indicates the maximum system input power consumption (in Watt). Legal Values Default cfgChassisPeakPowerTimestamp (Read Only) Description The timestamp recorded when the peak input power consumption value occurred.
PAGE 136
Default None cfgChassisRedundantState (Read Only) Description Legal Values Default Enables or disables power redundancy for the chassis. • • 0 (none) 1 (full) None cfgChassisDefaultPowerCapUpperBound (Read Only) Description Indicates the maximum default value to which you can set the power cap of a chassis. Legal Values 5000 Watt Default 5000 Watt cfgChassisDefaultPowerCapUpperBoundBTU(Read Only) Description Indicates the maximum default value to which you can set the power cap of a chassis.
PAGE 137
Default 16685 Watt 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 138
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 139
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 140
cfgChassisPowerButtonEnable (Read/Write) Description Indicates if the chassis power button is enabled or disabled. Legal Values • • Default 0 (disabled) 1 (enabled) None cfgSystemEnergyConsumptionClear (Write Only) Description Resets energy statistics when set to 1.
PAGE 141
cfgChassisServerBasedPowerMgmtMode Description Indicates the server-based power management mode of a chassis. Legal Values • • Default 0 (disabled) 1 (enabled) 0 (disabled) 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
To use this object property, you must have the Chassis Configuration Administrator privilege. cfgDvdMapping Read or Write Description Maps the slots to the DVD drive in the chassis: Legal Values 1, 2, 3, and 4 are the slot numbers that are specified. Default 1 cfgDvdSlotEnable Read or Write Description Enable the slots (1 to 4) to access the DVD: • • • • cfgDvdSlot1Enable cfgDvdSlot2Enable cfgDvdSlot3Enable cfgDvdSlot4Enable Legal Values 0 disables the mapping and 1 enables the mapping.
PAGE 143
cfgAlertingSourceEmailName Description Specifies the e-mail address used to send e-mail notifications when an event occurs. Legal Values Valid e-mail address Default None Examples racadm getconfig -g cfgAlerting -o cfgAlertingSourceEmailName racadm config -g cfgAlerting -o cfgAlertingSourceEmailName user@home.com Object value modified successfully. cfgIPv6LanNetworking This group is used to configure the IPv6 over LAN networking capabilities.
PAGE 144
• Default 0 (FALSE) 1 cfgIPv6Address Description Assigns a static IPv6 address to the CMC. This property is used only if cfgIPv6AutoConfig is set to 0 (false). Legal Values A string representing a valid IPv6 address. For example, 2001:DB8:1234:5678:9ABC:DE11:C00C:BEEF Default :: cfgIPv6PrefixLength (Read/Write) Description Specifies the prefix length for IPv6 address.
PAGE 145
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 146
cfgNicCurrentIPv4Enabled Description Indicates whether IPv4 is enabled on the CMC. If the current property value is set to 0 (false), the remote network interfaces to the CMC are not accessible over IPv4. Legal Values Default Example racadm getconfig -g cfgCurrentLanNetworking # cfgNicCurrentIPv4Enabled=1 # cfgNicCurrentIpAddress=143.166.152.116 # cfgNicCurrentNetmask=255.255.255.0 # cfgNicCurrentGateway=143.166.152.
PAGE 147
Default None cfgNicCurrentVlanEnable (Read Only) Description Indicates whether the VLAN is enabled. Legal Values 0- VLAN is disabled 1- VLAN is enabled Default None cfgNicCurrentVlanID (Read Only) Description Indicates the Current Virtual Lan ID Legal Values Integer Default None cfgNicCurrentVlanPriority (Read Only) Description Indicates the Current Virtual Lan Priority. Legal Values Integer Default None cfgDNSCurrentServer1 Description Displays the IP address for DNS server 1.
PAGE 148
To use this object property, you must have the CMC Login User privilege. cfgCurrentIPv6Enabled Description Indicates whether IPv6 is enabled on the CMC. If the current property value is set to 0 (false), the remote network interfaces to the CMC are not accessible over IPv6. Legal Values Default cfgCurrentIPv6AutoConfigWasUsed Description Indicates whether auto configuration is used to obtain IPv6 settings, including stateless IPv6 address(es) and gateway.
PAGE 149
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 150
• Default 1 (Full Duplex) 1 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. cfgNetTuningNicAutoneg (Read/Write) Description Legal Values Default Enables autonegotiation of physical link speed and duplex.
PAGE 151
cfgRacSecCsrOrganizationName (Read/Write) Description Specifies the CSR Organization Name (O). Legal Values A string of up to 254 characters. Default cfgRacSecCsrOrganizationUnit (Read/Write) Description Specifies the CSR Organization Unit (OU). Legal Values A string of up to 254 characters. Default cfgRacSecCsrLocalityName (Read/Write) Description Specifies the CSR Locality (L). Legal Values A string of up to 254 characters.
PAGE 152
cfgRacSecCountryCode= cfgRacSecEmailAddr= cfgRacSecCsrKeySize (Read/Write) Description Specifies the SSL asymmetric key size for the CSRs.