Back to Contents Page
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.
|
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 |
.
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 |
.
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 |
.
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 |
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 |
.
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 |
.
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 |
.
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) |
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.
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 |
.
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 |
.
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