Back to Contents Page

DRAC 4 Property Database Group and Object Definitions

Dell™ Remote Access Controller 4 Firmware Version 1.30 User's Guide

  idRacInfo

  cfgLanNetworking

  cfgCurrentLanNetworking

  cfgRemoteHosts

  cfgUserAdmin

  cfgTraps

  cfgSessionManagement

  cfgSerial

  cfgNetTuning

  cfgOobSnmp

  cfgRacTuning

  ifcRacManagedNodeOs

  cfgRacSecurity

  cfgRacVirtual

  cfgActiveDirectory

  Event Filter Operation and Event Mask Properties

  DRAC 4-Generated Event Mask Definitions

  System-Generated Alert Mask Definitions

  Alert Filter Properties

  Alert Test Commands


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.

Legal Values

See "DRAC 4-Generated Event Mask Definitions."

Default

0x777777

Description

See "DRAC 4-Generated Event Mask Definitions." (Type hexadecimal values.)

cfgUserAdminAlertFilterSysEventMask (Read/Write)

NOTE: To modify this property, you must have Configure Users permission.

Legal Values

See "System-Generated Alert Mask Definitions."

Default

0x777777

Description

See "System-Generated Alert Mask Definitions." (Type hexadecimal values.)

cfgUserAdminEmailEnable (Read/Write)

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.

Legal Values

See "DRAC 4-Generated Event Mask Definitions."

Default

0x300000

Description

See "DRAC 4-Generated Event Mask Definitions." (Type hexadecimal values.)

cfgTrapsFilterSysEventMask (Read/Write)

NOTE: To modify this property, you must have Configure DRAC 4 permission.

Legal Values

See "DRAC 4-Generated Event Mask Definitions."

Default

0x77777

Description

See "DRAC 4-Generated Event Mask Definitions." (Type hexadecimal values.)

cfgTrapsIndex (Read Only)

NOTE: To modify this property, you must have Configure DRAC 4 permission.

Legal Values

See "DRAC 4-Generated Event Mask Definitions."

Default

0x77777

Description

Index of Trap entry.


cfgSessionManagement

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

racadm config -g cfgNetTuning -o cfgNetTuningNicMtu <value>

racadm config -g cfgNetTuning -o cfgNetTuningIpTtl <value>

racadm config -g cfgNetTuning -o cfgNetTuningIpReassTtl <value>

racadm config -g cfgNetTuning -o cfgNetTuningTcpSrttBase <value>

racadm config -g cfgNetTuning -o cfgNetTuningTcpSrttDflt <value>

racadm config -g cfgNetTuning -o cfgNetTuningTcpReXmtMin <value>

racadm config -g cfgNetTuning -o cfgNetTuningTcpReXmtMax <value>

racadm config -g cfgNetTuning -o cfgNetTuningTcpMsl <value>

where <value> is obtained from Table B-2.

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.

Legal Values

Positive integers.

Default

0x400

Description

DRAC 4 SSL asymmetric key size. (Type hexadecimal values.)


cfgRacVirtual

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

If this object's property values is TRUE, it scans the event masks in the User 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:

Examples

then the event mask property value to use is 0x02244444. The following command sets this property value:

racadm -g cfgUserAdmin -o cfgUserAdminAlertFilterRacEventMask -i1 0x2244444

then the event mask property value to use is 0x00064444. The following command sets this property value:

racadm -g cfgTraps -o cfgTrapsFilterSysEventMask -i1 0x00064444


System-Generated Alert Mask Definitions

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:

where <statMask> has the following bit definitions:


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:

For more information, see the Server Administrator SNMP Reference Guide.


Back to Contents Page