Back to Contents Page

Controller Property Database Group and Object Definitions

Dell™ Embedded Remote Access/MC User's Guide

  idRacInfo

  cfgLanNetworking

  cfgCurrentLanNetworking

  cfgRemoteHosts

  cfgUserAdmin

  cfgTraps

  cfgSessionManagement

  cfgNetTuning

  cfgOobSnmp

  cfgRacTuning

  ifcRacManagedNodeOs


The controller property database contains information to help you configure your controller. Data about the controller is organized by associated objects, and objects are organized by object groups. The group and object IDs that are supported by the controller property database are contained in this section.

You can use group and object IDs as input to the racadm utility to set and retrieve controller data. The following definitions specify object data and indicate whether the object can be read, written to, or both.

The following subsections describe the groups and their member objects.

NOTICE: Object and group IDs in this section are system specific. Some may not be applicable to your system.

idRacInfo

This group contains display parameters to provide specific information for the controller being queried.

One instance of the group is allowed. The following table describes the objects in this group. A description, list of valid input/output values, and the default value for each object is given below the object name.

Table B-1. idRacInfo Objects 

Object Name

Description

Valid I/O Values

Default Value

idRacInfo (read only)

Identifies the type of RAC.

0=invalid; 1=other;
2=unknown; 3=RAC

0x04

idRacProductInfo (read only)

Using a text string, identifies what the product is.

String of up to 63 ASCII characters

ERA/MC

idRacDescriptionInfo (read only)

A text description of the RAC type.

String of up to 255 ASCII characters.

This system provides a complete set of remote management functions for Dell™ PowerEdge™ systems

idRacVersionInfo (read only)

A string containing the current firmware version of the product, where x is the current revision.

String of up to 63 ASCII characters.

Firmware version x.x (Build xx.xx)

idRacName (read/write)

A user assigned name to identify this controller.

String of up to 15 ASCII characters.

RAC

idRacMisc (read/write)

Generic property undefined at this release.

String of up to 63 ASCII characters.

Null string

.


cfgLanNetworking

This group contains parameters to configure the management Ethernet port interface.

One instance of the group is allowed. All objects in this group require a controller reset before they become active. The following table describes the objects in this group.

Table B-2. cfgLanNetworking Objects 

Object Name

Description

Valid I/O Values

Default Value

cfgNicEnable (read/write)

0=Disable, 1=Enable the management Ethernet port.

Boolean, either 1 or 0 (TRUE or FALSE).

1

cfgNicIpAddress (read/write)

The IP address of the management Ethernet port.

A string of "." separated numeric fields containing the static IP address.

192.168.0.201

cfgNicNetmask (read/write)

The network mask used by the management Ethernet port.

A string of "." separated numeric fields containing the static network mask.

255.255.255.0

cfgNicGateway (read/write)

The gateway used by the management Ethernet port.

A string of "." separated numeric fields containing the static gateway.

192.168.0.1

cfgNicUseDhcp (read/write)

Boolean, either 1 or 0 (TRUE or FALSE).

0=Use the static management Ethernet port parameters described above.

1=Use DHCP and obtain the necessary parameters from the DHCP server for the management Ethernet port.

1

.


cfgCurrentLanNetworking

This group contains parameters that are currently in use by the management Ethernet port.

One instance of the group is allowed. The following table describes the objects in this group.

Table B-3. cfgCurrentLanNetworking Objects

Object Name

Description

Valid I/O Values

Default Value

cfgNicCurrentIpAddress (read only)

The current IP address of the management Ethernet port.

A string of "." separated numeric fields containing the IP address.

None

cfgNicCurrentNetmask (read only)

The current network mask used by the management Ethernet port.

A string of "." separated numeric fields containing the network mask.

None

cfgNicCurrentGateway (read only)

The current gateway used by the management Ethernet port.

A string of "." separated numeric fields containing the gateway address.

None

cfgNicCurrentDhcpWasUsed (read only)

Indicates whether or not DHCP was used to configure the Ethernet port.

0 = IP address is static.

1 = IP address was obtained from a DHCP server.

Boolean, either 1 or 0 (TRUE or FALSE).

None

.


cfgRemoteHosts

The group contains parameters to configure various firmware update loading, IP addresses, enables, and so on. One instance of the group is allowed. This group contains parameters that are currently in use by the management Ethernet port.

One instance of the group is allowed. Table B-4 describes the objects in this group.

Table B-4. cfgRemoteHosts Objects 

Object Name

Description

Valid Input/Output Values

Default Value

cfgRhostsSmtpEmailEnable (read/write)

0=disable, 1=enable the SMTP protocol to send e-mail alerts. This object requires a controller reset before it becomes active

Boolean, either 1 or 0 (TRUE or FALSE).

1

cfgRhostsFwUpdateTftpEnable (read/write)

0=disable, 1=enable loading the firmware update file through TFTP. This object requires a controller reset before it becomes active.

boolean either 1 or 0 (TRUE or FALSE).

No string

cfgRhostsSmtpServerIpAddr (read/write)

The IP address of the server used in e-mail alerts. This object requires a controller reset before it becomes active.

A string of "." separated numeric fields containing the IP address.

127.0.0.1

cfgRhostsFwUpdateIpAddr (read/write)

The address of the TFTP server where the firmware update image is located.

A string of "." separated numeric fields containing the IP address.

192.168.0.4

cfgRhostsFwUpdatePath (read/write)

The path name pointing to the firmware update binary file. If FIRMIMG.BIN 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, such as C drive.

String of up to 255 ASCII characters that designate a valid path name.

FIRMIMG.BIN


cfgUserAdmin

This group contains parameters to allow configuration of users that are allowed access to the controller.

Sixteen instances of the group are allowed, which corresponds to a user for each index. The following table describes the objects in this group.

Table B-5. cfgUserAdmin Objects 

Object Name

Description

Valid I/O Values

Default Value

cfgUserAdminEmailEnable

0=Disable, 1=Enable e-mail alerting on a per user basis.

Boolean either 1 or 0 (true or false).

0

cfgUserAdminEmailAddress

Standard e-mail address such as john_doe@mycompany.com.

A string up to 63 ASCII characters.

""

cfgUserAdminEmailCustomMsg

User defined message to be sent on an e-mail alert.

A string up to 31 ASCII characters.

""

cfgUserAdminUserName (read/write)

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 deletes the user at that index. You cannot change the name. You must delete and then recreate.

NOTE: This command is the "anchor" for this indexed group

A string of up to 19 ASCII characters.

None

cfgUserAdminPassword (write only)

The password for this user. The user passwords are encrypted and cannot be seen or displayed after this property is written.

A string of up to 255 ASCII characters.

None

cfgUserAdminAlertFilterRacEventMask (read/write)

See "Alert-Related Properties." (Enter hexadecimal values.)

See "Alert-Related Properties."

0x300000

cfgUserAdminAlertFilterSysEventMask (read/write)

See "Alert-Related Properties." (Enter hexadecimal values.)

See "Alert-Related Properties."

0x77777

.


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 table describes the objects in this group.

Table B-6. cfgTraps Objects

Object Name

Description

Valid I/O Values

Default Value

cfgTrapsDestIpAddr (read/write)

IP address of an SNMP trap deamon.

NOTE: This object is the "anchor" for this indexed group.

A string of "." separated numeric fields containing the IP.

No string

cfgTrapsEnable (read/write)

0=Disabled, 1=Enabled for this indexed entry.

Boolean, either 1 or 0 (TRUE or FALSE).

1

cfgTrapsSnmpCommunity (read/write)

An SNMP community name.

A string of up to 31 ASCII characters.

No string

cfgTrapsFilterSysEventMask (read/write)

See "System-Generated Alert Mask Definition." (Enter hexadecimal values.)

See "System-Generated Alert Mask Definition."

0x77777

.


cfgSessionManagement

This group contains parameters to configure the number of sessions that can connect to the controller.

One instance of the group is allowed. All objects in this group require a controller reset before they become active. The following table describes the objects in this group.

Table B-7. cfgSessionManagement Objects

Object Name

Description

Valid I/O Values

Default Value

cfgSsnMgtMaxSessions (read/write)

The maximum number of simultaneous sessions that are allowed at one time from the controller Web-based remote access interface. (Enter hexadecimal values.)

0x1 through 0x10.

0x10 or 16

cfgSsnMgtMaxSessionsPerUser (read/write)

The maximum number of simultaneous sessions allowed per user. (Enter hexadecimal values.)

0x1 through 0x10.

0x10 or 16

.


cfgNetTuning

The group contains parameters to tune the controller network configuration.

One instance of the group is allowed. All objects in this group require a controller reset before they become active. The following table describes the objects in this group.

Table B-8. cfgNetTuning Objects 

Object Name

Description

Valid I/O Values

Default Value

cfgNetTuningNicMtu (read/write)

The size in bytes of the maximum transmission unit used by the management Ethernet port. (Enter hexadecimal values.)

Integer from 576 to 1500.

0x5dc (1500)

cfgNetTuningIpTtl (read/write)

The maximum IP packet time to live in seconds. (Enter hexadecimal values.)

Integer from 1 to 255.

0x40 (64)

cfgNetTuningIpReassTtl (read/write)

Integer from 60 to 240.

The maximum IP packet fragment reassembly time in 0.5 second units. (Enter hexadecimal values.)

0x3c (60)

cfgNetTuningTcpSrttBase (read/write)

The smoothed round trip time-out base minimum value for TCP round trip retransmission time in ½ second units. (Enter hexadecimal values.)

Integer from 0 to 256.

0x0 (0)

cfgNetTuningTcpSrttDflt (read/write)

The smoothed round trip time-out base default value for TCP retransmission round trip time in ½ second units. (Enter hexadecimal values.)

Integer from 6 to 384.

0x6 (6)

cfgNetTuningTcpReXmtMin (read/write)

The minimum number of TCP retransmission time in ½ second units. (Enter hexadecimal values.)

Integer from 2 to 1024.

0x2 (2)

cfgNetTuningTcpReXmtMax (read/write)

The maximum number of TCP retransmission time in ½ second units. (Enter hexadecimal values.)

Integer from 8 to 1024.

0x80 (128)

cfgNetTuningTcpMsl (read/write)

The maximum TCP segment lifetime in ½ second units. (Enter hexadecimal values.)

Integer from 60 to 240.

0x3c (60)

Tuning the RAC for Satellite Connectivity

The racadm utility may be used to modify the network tuning properties of the controller. 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-9.

Table B-9. Satellite Connectivity Values

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 these parameters can be configured, it is recommended that you not use any other settings than those detailed here. Other settings may adversely effect the controller's ability to communicate with other network nodes.

Following the modification of the network tuning, the controller must be reset for the new tuning values to take effect. After the controller 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 controller.

One instance of the group is allowed. All objects require a controller reset before they become active. The following table describes the objects in this group.

Table B-10. cfgOobSnmp Objects

Object Name

Description

Valid I/O Values

Default Value

cfgOobSnmpTrapsEnable (read/write)

0=Disable, 1=Enable transmission of SNMP traps.

Boolean, either 1 or 0 (TRUE or FALSE).

1

cfgOobSnmpAgentEnable (read/write)

0=Disable, 1=Enables the controller SNMP agent.

boolean either 1 or 0 (TRUE or FALSE).

1

.


cfgRacTuning

The group contains various tuning configuration parameters.

One instance of the group is allowed. The following subsections describe the objects in this group.

Table B-11. cfgRacTuning Objects 

Object Name

Description

Valid Input/Output Values

Default Value

cfgRacTuneGenericFtpUser (read/write)

The user name used in FTP authentication.

A string of up to 15 ASCII characters.

racadm

cfgRacTuneGenericFtpPasswd (read/write)

The user password.

A string of up to 15 ASCII characters.

racadm

cfgRacTuneFwUpdateResetDelay (read/write)

The maximum number in seconds to wait between when the firmware update file is loaded, and the update sequence is started. (Enter hexadecimal values.)

Integer from 0 to 600.

0x46 or 70

cfgRacTuneDialOutIdleTime (read/write)

0=infinite, otherwise when line is idle for this many seconds, the line is disconnected. This object requires a controller reset before it becomes active. (Enter hexadecimal values.)

Integer from 0 to any positive value.

0x28 or 40

cfgRacTuneD3debugEnable (read/write)

0=disable, 1=enable the RAC debug command. This object requires a controller reset before it becomes active.

Boolean, either 1 or 0 (TRUE or FALSE).

1

cfgRacTuneRemoteRacadmEnable (read/write)

0=disable, 1=enable

This object requires a controller reset before it becomes active.

Boolean, either 1 or 0 (TRUE or FALSE).

1

.


ifcRacManagedNodeOs

This group contains parameters to configure the controller with managed system and operating system naming information.

One instance of the group is allowed. The following table describes the objects in this group.

Table B-12. cfgRacManagedNodeOs Objects

Object Name

Description

Valid I/O Values

Default Value

ifcRacMnOsHostname (read/write)

The host name of the managed system.

A string of up to 255 ASCII characters

No string

ifcRacMnOsOsName (read/write)

The operating system name of the managed system.

A string of any ASCII characters

No string

ifcRacMnOsOsType (read only)

See the getsysinfo command.

Not user writable

0xffffffff

.


Back to Contents Page