The DRAC 4 property database contains the configuration information for the DRAC 4. 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.
Use the group and object IDs with the racadm utility to configure the DRAC 4. The following sections describe each object and indicate whether the object is readable, writable, or both.
idRacInfo
This group contains display parameters to provide information about the specifics of the DRAC 4 being queried.
One instance of the group is allowed. The following subsections describe the objects in this group.
idRacProductInfo (Read Only)
Legal Values
String of up to 63 ASCII characters.
Default
DRAC 4
Description
Uses a text string to identify the product.
idRacDescriptionInfo (Read Only)
Legal Values
String of up to 255 ASCII characters.
Default
RAC
Description
A text description of the RAC type.
idRacVersionInfo (Read Only)
Legal Values
String of up to 63 ASCII characters.
Default
RAC Firmware Version x.x
Description
A string containing the current firmware version of the product, where x is the current revision.
idRacName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
String of up to 15 ASCII characters.
Default
RAC
Description
A user assigned name to identify this controller.
idRacMisc (Read/Write)
Legal Values
String of up to 63 ASCII characters.
Default
Null string
Description
Generic property undefined at this release.
idRacType (Read)
Default
5
Description
Identifies the remote access controller type as the DRAC 4.
cfgLanNetworking
This group contains parameters to configure the DRAC 4 NIC.
One instance of the group is allowed. All objects in this group will require the DRAC 4 NIC to be reset, which may cause a brief loss in connectivity. Objects that change the DRAC 4 NIC IP address settings will close all active user sessions and require users to reconnect using the updated IP address settings.
cfgDNSDomainNameFromDHCP (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
0
Description
Obtains the domain name from the DHCP server. This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE).
cfgDNSDomainName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
String of up to 254 ASCII characters. At least one of the characters must be alphabetic.
NOTE: Microsoft Active Directory only supports Fully Qualified Domain Names (FQDN) of 64 bytes or
fewer.
Default
MYDOMAIN
Description
The DNS domain name. This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE) and if cfgDNSDomainNameFromDHCP is set to 0 (FALSE).
cfgDNSRacName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
String of up to 63 ASCII characters. At least one of the characters must be alphabetic.
NOTE: Some DNS servers only register names of 31 characters or fewer.
Default
RAC-service tag
Description
Displays the RAC name, which is RAC-service tag (by default). This parameter is only valid if cfgDNSRegisterRac is set to 1 (TRUE).
cfgDNSRegisterRac (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
0
Description
Registers the DRAC 4 name on the DNS server.
cfgDNSServersFromDHCP (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
0
Description
Retrieves DNS server addresses from the DHCP server.
cfgDNSServer1 (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Any legal IP address.
Default
192.168.0.5
Description
Retrieves the IP address for DNS server 1. This parameter is only valid if cfgDNSServersFromDHCP parameter is set to 0 (FALSE).
NOTE: cfgDNSServer1 and cfgDNSServer2 may be set to identical values while swapping addresses.
cfgDNSServer2 (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Any legal IP address, including 0.0.0.0.
Default
192.168.0.6
Description
Retrieves the IP 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.
cfgNicEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
1
Description
0=Disable.
1=Enable the DRAC 4 NIC.
cfgNicIpAddress (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of "." separated numeric fields containing the static IP address.
Default
192.168.0.120
Description
The IP address of the DRAC 4 NIC.
cfgNicNetmask (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of "." separated numeric fields containing the static network mask.
Default
255.255.255.0
Description
The network mask used by the DRAC 4 NIC.
cfgNicGateway (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of "." separated numeric fields containing the static gateway.
Default
192.168.0.120
Description
The gateway used by the DRAC 4 NIC.
cfgNicUseDhcp (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE)
Default
0
Description
0=Use the static DRAC 4 NIC parameters described above.
1=Use DHCP and obtain the necessary parameters from the DHCP server for the DRAC 4 NIC.
cfgNicMacAddress (Read Only)
Description
MAC address for the integrated NIC.
cfgCurrentLanNetworking
This group contains parameters that are currently in use by the DRAC 4 NIC.
One instance of the group is allowed. The following subsections describe the objects in this group.
cfgNicCurrentIpAddress (Read Only)
Legal Values
A string of "." separated numeric fields containing the IP address
Default
None
Description
The current IP address of the DRAC 4 NIC.
cfgNicCurrentNetmask (Read Only)
Legal Values
A string of "." separated numeric fields containing the network mask.
Default
None
Description
The current network mask used by the DRAC 4 NIC.
cfgNicCurrentGateway (Read Only)
Legal Values
A string of "." separated numeric fields containing the gateway address.
Default
None
Description
The current gateway used by the DRAC 4 NIC.
cfgNicCurrentDhcpWasUsed (Read Only)
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
None
Description
Indicates whether or not DHCP was used to configure the NIC.
0 = IP address is static
1 = IP address was obtained from a DHCP server.
cfgDNSCurrentDomainName (Read Only)
Description
Current DNS domain name.
cfgDNSCurrentServer1 (Read Only)
Description
Current IP address used for DNS Server 1.
cfgDNSCurrentServer2 (Read Only)
Description
Current IP address used for DNS Server 2.
cfgRemoteHosts
The group contains parameters to configure various firmware update loading, IP addresses, enables, and so on.
One instance of the group is allowed. The following subsections describe the objects in this group.
cfgRhostsSmtpEmailEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
1
Description
0=disable, 1=enable the SMTP protocol to send email alerts.
cfgRhostsSmtpServerIpAddr (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of "." separated numeric fields containing the IP address.
Default
127.0.0.1
Description
The IP address of the server used in email alerts.
cfgRhostsFwUpdateTftpEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean either 1 or 0 (TRUE or FALSE).
Default
1
Description
0=Disable, 1=Enable loading the firmware update file through TFTP.
cfgRhostsFwUpdateIpAddr (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of "." separated numeric fields containing the IP address.
Default
192.168.0.4
Description
The address of the TFTP server where the firmware update image is located.
cfgRhostsFwUpdatePath (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
String of up to 255 ASCII characters that designate a valid path name.
Default
""
Description
The path name pointing to the firmware update binary file. If this is a file name only, then the path needs to be specified in the TFTP server. Otherwise, the entire path can be specified here.
NOTE: The server may still require you to specify the drive (for example, C).
cfgUserAdmin
This group contains parameters that you can use to configure which users are allowed access to the DRAC 4.
Sixteen instances of the group are allowed, which corresponds to a user for each index. The following subsections describe the objects in this group.
cfgUserAdminPrivilege (Read/Write)
NOTE: To modify this property, you must have Configure Users permission.
Legal Values
0x80000000 to 0x800001ff, and 0x0
Default
0
Description
Use the bit mask numbers in Table B-1 to set role-based authority privileges for a DRAC 4 user.
Table B-1. Bit Masks for User Privileges
User Privilege
Bit Mask
Log In To DRAC 4
0x80000001
Configure DRAC 4
0x80000002
Configure Users
0x80000004
Clear Logs
0x80000008
Execute Server Control Commands
0x80000010
Access Console Redirection
0x80000020
Access Virtual Media
0x80000040
Test Alerts
0x80000080
Execute Debug Commands
0x80000100
cfgUserAdminUserName (Read/Write)
NOTE: To modify this property, you must have Configure Users permission.
Legal Values
A string of up to 19 ASCII characters.
Default
None
Description
The name of the user for this index. The user index is created by writing a string into this name field if the index is empty. Writing a string of double quotes ("") deletes the user at that index. You cannot change the name. You must delete and then recreate the name. The string must not contain "/" (forward slash, "\" (backslash), "." (period), "@" (at symbol) or quotations marks.
NOTE: This command is the "anchor" for this indexed group.
cfgUserAdminPassword (Write Only)
NOTE: To modify this property, you must have Configure Users permission.
Legal Values
A string of up to 20 ASCII characters.
Default
None
Description
The password for this user. The user passwords are encrypted and cannot be seen or displayed after this property is written.
cfgUserAdminAlertFilterRacEventMask (Read/Write)
NOTE: To modify this property, you must have Configure Users permission.
NOTE: To modify this property, you must have Configure Users permission.
Legal Values
Boolean either 1 or 0 (TRUE or FALSE).
Default
0
Description
0=Disable, 1=Enable email alerting on a per user basis.
cfgUserAdminEmailAddress (Read/Write)
NOTE: To modify this property, you must have Configure Users permission.
Legal Values
A string of up to 63 ASCII characters.
Default
""
Description
Standard email address, such as john_doe@mycompany.com.
cfgUserAdminEmailCustomMsg (Read/Write)
NOTE: To modify this property, you must have Configure Users permission.
Legal Values
A string of up to 31 ASCII characters.
Default
""
Description
User-defined message to be sent on a email alert.
cfgUserAdminIndex (Read Only)
Description
Index of user entry.
cfgTraps
This group contains parameters to configure the delivery of SNMP traps.
Sixteen instances of this group are allowed, which represent sixteen unique trap destinations. The following subsections describe the objects in this group.
cfgTrapsDestIpAddr (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of "." separated numeric fields containing the IP.
Default
""
Description
IP address of an SNMP trap daemon.
NOTE: This object is the "anchor" for this indexed group.
cfgTrapsEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
1
Description
0=Disabled, 1=Enabled for this indexed entry.
cfgTrapsSnmpCommunity (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of up to 31 ASCII characters.
Default
""
Description
A SNMP community name.
cfgTrapsFilterRacEventMask (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
This group contains parameters to configure the number of sessions that can connect to the DRAC 4.
One instance of the group is allowed. All objects in this group require a DRAC 4 reset before they become active. The following subsections describe the objects in this group.
cfgSsnMgtMaxSessions (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0x1 through 0x4
Default
0x4
Description
The maximum number of simultaneous sessions that are allowed at one time from the DRAC 4 Web-based remote access interface. (Type hexadecimal values.)
cfgSsnMgtMaxSessionsPerUser (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0x1 through 0x4
Default
0x4
Description
The maximum number of simultaneous sessions allowed per user. (Type hexadecimal values.)
cfgSsnMgtSshTelnetIdleTimeout (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0x0 through 0x780 seconds (0-32 minutes)
0 = No timeout
Default
0x12C seconds (5 minutes)
Description
Defines the Secure Shell idle timeout. 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).
cfgSerial
This group contains configuration parameters for the system external serial port.
One instance of the group is allowed. The following subsections describe the objects in this group.
cfgSerialBaudRate (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
NOTE: For best results redirecting BIOS System Setup screens, Dell recommends using 115200.
Legal Values
9600, 28800, 57600, 115200
Default
115200
Description
Sets the baud rate on the external serial port. (Type decimal values).
cfgSerialConsoleEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
0
Description
0=Disabled, 1=Enabled. Enables the serial port and terminal interface.
cfgSerialConsoleQuitKey (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of 3 or less characters.
Default
The <CR><~><.> key combination
The <CR> key represents a carriage return; press <Enter> as a substitute for <CR>.
Description
This key sequence terminates text console redirection when using VT-100.
cfgSerialConsoleIdleTimeout (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 1 to any positive number. Type hexadecimal values.
Default
0x12c
Description
The maximum number of time (in seconds) of line idle time before the line is disconnected. (Type hexadecimal values.)
cfgSerialConsoleShellType (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 = VT100 block screen interface, has limited command function compared to type 2.
2 =UNIX-style command line data stream interface.
Default
Default 2
Description
Sets the serial console shell type. (Type hexadecimal values.)
cfgSerialConsoleNoAuth (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0 – Login prompt is Enabled on the serial shell.
1 – Login prompt is Disabled on serial shell.
Default
0
Description
Allows you to disable authentication on the serial shell.
cfgSerialConsoleCommand (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Description
The serial command runs after login at the start of a session and allows you to set up a command such as connect com2 that autoruns when a session begins.
Default
Empty string (no command).
Example
connect com2
cfgSerialHistorySize (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Any integer less than or equal to 8192. (If a value larger than 8192 is supplied, no error is returned and the history size is set to 8192.)
Default
8192 characters
Description
Sets the size of the serial history buffer.
cfgSerialSshEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0=disabled, 1=enabled
Default
1=enabled
Description
Enables/disables secure shell on the DRAC 4.
cfgSerialTelnetEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Description
Enables/disables telnet console
Default
0=telnet disabled
Legal Values
0=disabled, 1=enabled
cfgSerialCom2RedirEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Description
Enables/disables the console through the COM 2 port
Default
1=COM 2 (console enabled)
Legal Values
0=Disabled, 1=Enabled
cfgSerialTelnet7flsBackspace (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Description
When enabled, the DRAC 4 will interpret 0x7f characters as backspaces from a telnet session. Some telnet clients send 0x7f characters when you press <Backspace>. Normally, when you press <Backspace>, 0x08 characters are sent.
Default
0
Legal Values
0=Disabled, 1=Enabled
cfgNetTuning
The group contains parameters to tune the DRAC 4 network configuration.
One instance of the group is allowed. All objects in this group require a DRAC 4 reset before they become active. The following subsections describe the objects in this group.
cfgNetTuningNicAutoneg (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 or 0
Default
1
Description
Enables autonegotiation of physical link speed and duplex. If enabled, autonegotiation takes priority over values set in the cfgNetTuningNic100MB and cfgNetTuningNicFullDuplex objects.
cfgNetTuningNic100MB (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 or 0
Default
1
Description
Sets the DRAC 4 link speed to 100 Mbit (1) or 10 Mbit (0).
cfgNetTuningNicFullDuplex (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 or 0
Default
1
Description
Sets the duplex to full duplex(1) or half duplex (0).
cfgNetTuningNicMtu (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 576 to 1500.
Default
0x5dc (1500).
Description
The size in bytes of the maximum transmission unit used by the DRAC 4 NIC. (Type hexadecimal values.)
cfgNetTuningIpTtl (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 1 to 255.
Default
0x40 (64)
Description
The maximum IP packet time to live in seconds. (Type hexadecimal values.)
cfgNetTuningIpReassTtl (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 60 to 240.
Default
0x3c (60)
Description
The maximum IP packet fragment reassembly time in ½ second units. (Type hexadecimal values.)
cfgNetTuningTcpSrttBase (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 0 to 256.
Default
0x0 (0)
Description
The smoothed round trip time-out base minimum value for TCP round trip retransmission time in ½ second units. (Type hexadecimal values.)
cfgNetTuningTcpSrttDflt (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 6 to 384.
Default
0x6 (6)
Description
The smoothed round trip time-out base default value for TCP retransmission round trip time in ½ second units. (Type hexadecimal values.)
cfgNetTuningTcpReXmtMin (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 2 to 1024.
Default
0x2 (2)
Description
The minimum number of TCP retransmission time in ½ second units. (Type hexadecimal values.)
cfgNetTuningTcpReXmtMax (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 8 to 1024.
Default
0x80 (128)
Description
The maximum number of TCP retransmission time in ½ second units. (Type hexadecimal values.)
cfgNetTuningTcpMsl (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 60 to 240.
Default
0x3c (60)
Description
The maximum TCP segment lifetime in ½ second units. (Type hexadecimal values.)
cfgNetTuningIpSubnetsAreLocal (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 or 0
Default
1
Description
Packets addressed to subnets of the local net do not go to the gateway.
Tuning the DRAC 4 for Satellite Connectivity
The racadm CLI may be used to modify the network tuning properties of the DRAC 4. It is also possible to use the racadm.cfg file to modify these properties (similar to the manner in which .ini files are used).
Table B-2. DRAC 4 Properties for Satellite Connectivity
Property
Normal Value
Satellite Value
cfgNetTuningNicMtu
0x5dc
0x1f4
cfgNetTuningIpTtl
0x40
0x80
cfgNetTuningIpReassTtl
0x3c
0x78
cfgNetTuningTcpSrttBase
0
0x100
cfgNetTuningTcpSrttDflt
0x6
0x180
cfgNetTuningTcpReXmtMin
0
0
cfgNetTuningTcpReXmtMax
0x80
0x400
cfgNetTuningTcpMsl
0x3c
0xf0
NOTICE: Although you can configure these parameters, it is recommended that you only use the
settings described here. Other settings may adversely effect the DRAC 4's ability to communicate with
other network nodes.
Following the modification of the network tuning, the DRAC 4 must be reset for the new tuning values to take effect. After the DRAC 4 has been reset, it should be available for use in a normal or satellite network configuration.
cfgOobSnmp
The group contains parameters to configure the SNMP agent and trap capabilities of the DRAC 4.
One instance of the group is allowed. The following subsections describe the objects in this group.
cfgOobSnmpAgentCommunity (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of up to 31 ASCII characters.
Default
public
Description
Use this to modify the SNMP Community Name.
cfgOobSnmpTrapsEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission. This object requires a DRAC
4 reset before it becomes active.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE)
Default
1
Description
0=Disable,1=Enable transmission of SNMP traps.
cfgOobSnmpAgentEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission. This object requires a DRAC
4 reset before it becomes active.
Legal Values
Boolean either 1 or 0 (TRUE or FALSE).
Default
0
Description
0=Disable, 1=Enable the DRAC 4 SNMP agent.
cfgRacTuning
The group contains various tuning configuration parameters.
One instance of the group is allowed. The following subsections describe the objects in this group.
cfgRacTuneHttpPort (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0 – 65535
Default
80
Description
Use this property to configure the DRAC 4 HTTP port. (Type hexadecimal values.)
cfgRacTuneHttpsPort (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0 – 65535
Default
443
Description
Use this property to configure the DRAC 4 HTTPS port. (Type hexadecimal values.)
cfgRacTuneSshPort (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0 – 65535
Default
22
Description
Use this property to configure the DRAC 4 SSH port. (Type hexadecimal values.)
cfgRacTuneTelnetPort (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0 – 65535
Default
23
Description
Use this property to configure the DRAC 4 telnet port. (Type hexadecimal values.)
cfgRacTuneFwUpdateResetDelay (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer from 0 to 600.
Default
0x46 or 70
Description
The maximum number in seconds to wait between when the firmware update file is loaded, and the update sequence is started. (Type hexadecimal values.)
cfgRacTuneD3debugEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
1
Description
0=disable, 1=enable the DRAC 4 debug command.
cfgRacTuneRemoteRacadmEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Boolean, either 1 or 0 (TRUE or FALSE).
Default
1
Description
0=Disable,1=Enable
cfgRacTuneHostCom2BaudRate (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
115200, 57600, 19200, and 9600
Default
57600
NOTE: For best results when redirecting BIOS System Setup screens, Dell recommends setting this baud
rate to 57600.
cfgRacTuneConRedirPort (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
0-65535
Default
5900 (0x170c)
Description
Determines the port used during vKVM sessions with the Console Redirection window. After changing this property, the RAC must be reset prior to opening any new Console Redirection sessions. (Type hexadecimal values.)
NOTE: This object requires a DRAC 4 reset before it becomes active.
ifcRacManagedNodeOs
This group contains parameters to configure the DRAC 4 with managed system and operating system naming information.
One instance of the group is allowed. The following subsections describe the objects in this group.
ifcRacMnOsHostname (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of up to 255 ASCII characters.
Default
""
Description
The host name of the managed system.
ifcRacMnOsOsName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of any ASCII characters.
Default
""
Description
The operating system name of the managed system.
ifcRacMnOsOsType (Read Only)
Legal Values
Not user-writable.
Default
0
Description
Manage system operating system type.
cfgRacSecurity
This group contains parameters to configure the DRAC 4 SSL (Secure Sockets Layer) security features.
cfgRacSecCsrCommonName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of any ASCII characters
Default
""
Description
The CSR (certificate signing request) common name.
cfgRacSecCsrOrganizationName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of any ASCII characters.
Default
""
Description
The CSR organization name.
cfgRacSecCsrOrganizationUnit (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of any ASCII characters.
Default
""
Description
The CSR organization unit.
cfgRacSecCsrLocalityName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of any ASCII characters.
Default
""
Description
The CSR locality name.
cfgRacSecCsrStateName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of any ASCII characters.
Default
""
Description
The CSR state.
cfgRacSecCsrCountryCode (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
The two-letter country code.
Default
""
Description
The CSR country code.
cfgRacSecCsrEmailAddr (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
A string of any ASCII characters.
Default
""
Description
The CSR email address.
cfgRacSecCsrKeySize (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
This group contains parameters to configure the DRAC 4 Virtual Media feature. One instance of the group is allowed. The following subsections describe the objects in this group.
cfgFloppyEmulation (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 or 0 (True or False)
Default
0
Description
0 (False) is the default setting, causing the DRAC 4 IDE Option ROM utility to display DELL VIRTUALS-120 instead of VIRTUALFLOPPY DRIVE. Operating systems, such as Microsoft Windows, assign drive letters A or B to the RAC Virtual Floppy drive and configure the drive as a floppy drive. The RAC Virtual CD is required to assign drive letters D and higher.
cfgVirMediaDisable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 or 0 (Disabled or Enabled)
Default
0 (Enabled)
Description
0 (Enabled) enables the Dell Virtual floppy on the next system restart.
1 (Disabled) disables the Dell Virtual floppy and CD-ROM on the next system restart. After restart:
The operating system cannot access the drives.
The virtual devices do not appear in the BIOS Setup screen.
The DRAC 4 IDE Option ROM utility displays the following messages when this feature is disabled:
Drive Number: 0 failed to detect Virtual device
Drive Number: 1 failed to detect Virtual device
NOTE: You must restart your system to enable all changes.
cfgVirAtapiSrvPort (Read/Write)
NOTE: To modify this property, you must have Access Virtual Media permission.
Legal Values
Any unused port number between 0 and 65535 decimal.
Default
0E54 in hexadecimal(3668 in decimal)
Description
Sets the port number or virtual media connection. (Type hexadecimal values).
cfgActiveDirectory
This group contains parameters to configure the DRAC 4 Active Directory feature.
cfgADRacDomain (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Any printable text string with no white space. Length is limited to 254 characters.
Default
(blank)
Description
Active Directory Domain in which the DRAC resides.
cfgADRacName (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Any printable text string with no white space. Length is limited to 254 characters.
Default
(blank)
Description
Name of DRAC as recorded in the Active Directory forest.
cfgADEnable (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
1 or 0 (True or False)
Default
0
Description
1 (True) allows Active Directory authentication to take place. 0 (False) enables local DRAC 4 authentication only.
cfgADAuthTimeout (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Integer greater than 15
Default
0x78 (120 seconds)
Description
Time in seconds to wait for Active Directory queries to complete. (Type hexadecimal values.)
cfgADRootDomain (Read/Write)
NOTE: To modify this property, you must have Configure DRAC 4 permission.
Legal Values
Any printable text string with no white space. Length is limited to 254 characters.
Default
(blank)
Description
Root domain of the Domain Forest.
Event Filter Operation and Event Mask Properties
The DRAC 4 alert filter scans the alert enable database properties before it scans the event masks. (An event mask is a bit sequence that specifies information about the DRAC 4- or managed-system-generated event, such as the event's origin, type, and severity).
NOTE: Throughout this document, objects are always referred to by group name and object name,
separated by a space.
The DRAC 4 alert filter operates according to the following general steps:
The DRAC 4 alert filter scans all of the objects in the alert enable property group ID is cfgUserAdmin. The object ID for this group is:
cfgUserAdmin cfgUserAdminPageEmailEnable
If this object's property values is TRUE, it scans the event masks in the User table.
The DRAC 4 alert filter scans the cfgTraps cfgTrapsEnable object. If this object's property value is TRUE, it scans the event masks in the Traps table.
The following subsections describe the event masks for DRAC 4-generated events and managed-system-generated events defined in the User table and the Trap table.
DRAC 4-Generated Event Mask Definitions
The cfgUserAdmin cfgUserdminAlertFilter {Rac, Sys} EventMask properties are an unsigned 32-bit integer property that holds the filter information for DRAC 4-generated events. The bit definitions in Table B-3 apply.
Table B-3. DRAC 4-Generated Event Mask Bit Definitions
Bits
Data
Type
28–31
DRAC 4 undefined
reserved
24–27
DRAC 4 miscellaneous alerts
<Miscmask>
20–23
DRAC 4 BMC communication alerts
<BMCmask>
where <bmcMask> has the following bit definitions:
Bit-0: 1 = Send alert for DRAC 4 communication with BMC and lost or restored communication between the DRAC 4 and BMC.
Bit-1: 1 = Send alert for DRAC 4 lost communication with BMC.
Bit-2: Reserved.
Bit-3: Reserved.
Examples
If you want to define alerts for the following:
Critical voltage or temperature sensors
Lost communication with the BMC
then the event mask property value to use is 0x02244444. The following command sets this property value:
The cfgTraps cfgTrapsFilter {Rac, Sys} EventMask properties are an unsigned 32-bit integer property that holds the filter information for managed-system generated events. The bit definitions in Table B-4 apply.
Table B-4. System-Generated Alert Mask Bit Definitions
Bits
Data
Type
28–31
System undefined
reserved
24–27
System undefined
reserved
20–23
System undefined
reserved
16–19
System status alerts
<statMask>
12–15
System miscellaneous sensor
<senMask>
8–11
System fan sensors
<senMask>
4–7
System voltage sensors
<senMask>
0–3
System temperature sensors
<senMask>
where <senMask> has the following bit definitions:
Bit-0: 1 = Send alert for informational events (such as a return to lower severity range or normal).
Bit-1: 1 = Send alert for warning (noncritical) events.
Bit-2: 1 = Send alert for critical events.
Bit-3: Reserved.
where <statMask> has the following bit definitions:
Bit-0: 1 = Send alert when system transitions to a powered-on state.
Bit-1: 1 = Send alert when system transitions to a powered-off state.
Bit-2: 1 = Send alert when watchdog timer detects a system hang.
Bit-3: Reserved.
Alert Filter Properties
The alert filter property group ID is cfgUserAdmin. The object IDs are shown in Table B-5.
Table B-5. Alert Filter Property Group and Object IDs
GroupID
Object ID
Object Default Value
cfgUserAdmin
cfgUserAdminPageEmailEnable
FALSE
cfgUserAdmin
cfgUserAdminPageEmailAddress
""
cfgUserAdmin
cfgUserAdminPageEmailCustomMsg
""
cfgUserAdmin
cfgUserAdminAlertFilterRacEventMask
0x777777
cfgUserAdmin
cfgUserAdminAlertFilterSysEventMask
0x777777
cfgRemoteHosts
cfgRhostsSmtpServerIpAddr
0.0.0.0
cfgOobSnmp
cfgOobSnmpTrapsEnable
TRUE
cfgTraps
cfgTrapsDestIpAddr
0.0.0.0
cfgTraps
cfgTrapsEnable
FALSE
cfgTraps
cfgTrapsSnmpCommunity
""
cfgTraps
cfgTrapsFilterRacEventMask
0x777777
cfgTraps
cfgTrapsFilterSysEventMask
0x777777
Alert Test Commands
You can test alerts using test commands. The racadm command has subcommands that test the different types of alert interfaces. These object ID sets cause the firmware to execute the subcommand with the option that indicates the test alert type to test. The test message is preset in properties for each test alert type. The types of alerts are email and trap.
The following subsection describes the command interfaces and the operation of the subcommand for each option.
Email Test Command
Synopsis
racadm testemail -e -i <index>
racadm testemail -e -u <username>
Alert Data Definitions
The email alert contains the following information: message (including test message, if a paging test), event description, date, time, severity, system ID, model, BIOS version, asset tag, service tag, managed system name, operating system name, and BMC version. The following is an example test email (fields shown are examples only and may not reflect actual observed output for your environment):
Subject: Alert from Dell Remote Access Card: 10.35.10.108
Message: TEST PAGE
Event: Email paging test to user 1
Date: 06-jun-2004
Time: 00:01:37
Severity: Info/Normal
System ID: Bbn
Model: Dell PowerEdge 2800
BIOS version: A00
Asset tag: 181676
Service tag: 6X713
Hostname: P2-750-08
OS Name: Linux 7.1 for the Itanium Processor
BMC Version: 1.3
Trap Test Command
Synopsis
racadm testtrap -t -i <trap index>
Alert Data Definitions
The "alertMessage" string (up to 1 KB) provides the specific information describing the cause and specific source of the event, which includes:
Sensor identification: entity/IPMBslaveAddress
Sensor number
Sensor ID string (if possible)
Current reading and range (normal/warning/critical)
Threshold values: minimum, maximum, normal
For more information, see the Server Administrator SNMP Reference Guide.
