Dell OpenManage™ Server Administrator Version 1.4 Command Line Interface User's Guide
The omconfig rac command enables you to configure the operational components of the Remote Access Service (RAS). The CLI command omconfig rac uses the remote access controller (RAC) software interface to configure these operational components.
 |
NOTE: Some features documented may not be available on your system's RAC. For example, dial/up modem use is supported only on DRAC III. |
For information on how to use Server Administrator to configure other system and main system chassis components, see "omconfig: Managing Components Using the Instrumentation Service." For information on how to use the omconfig system command to view and to manage cost of ownership information (assetinfo), see "omconfig system assetinfo: Editing Cost of Ownership Values."
Often you must use omreport rac commands to get information you need to execute an omconfig rac command. For information about the omreport rac command, see "omconfig rac: Managing the Remote Access Controller."
Parameter tables list input parameters for a command in the order in which you must configure them instead of the order in which they appear in the command line interface.
The symbol |, often called pipe, is the logical exclusive or operator. For example, enable | disable means that you can enable or disable the component or feature, but you cannot simultaneously enable and disable the component or feature.
|
NOTE: You must reset the remote access controller after execution of each omconfig rac command. After resetting the remote access controller, you must also wait approximately one minute before executing a subsequent omconfig rac command. |
|
NOTE: Although this section lists all possible omconfig rac commands, the commands available on your system depend on your system configuration. If you try to get help or execute a command for a component that is not installed on your system, Server Administrator issues a message that the component or feature is not found on this system. |
Table 10-1 is a high-level summary of the omconfig rac command. The column titled "Command level 3" lists the major arguments that can be used with omconfig rac. "User privilege required" refers to the type of privilege you need to execute the command, where U=User, P=Power User, and A=Administrator. "Use" is a very general statement about the actions that can be performed using omconfig rac. More details about syntax and use of the command appear later in this section.
Table 10-1. Command Level 1, Command Level 2, and Command Level 3 Options for omconfig rac
|
Command level 1 |
Command level 2 |
Command level 3 |
User privilege required |
Use |
|---|---|---|---|---|
Use the omconfig rac -? command to get a list of the available commands for omconfig rac.
Use omconfig rac <command level 3> -? to see a list of name=value pairs that you may need to use with dialinusers, dialoutusers, modem, network, remote, and so on.
omconfig rac dialinusers -?
The following is an excerpt of the Server Administrator response:
dialinusers Set dial-in user properties.
Valid parameters are:
username=<text:Reqd>
index=<number:0-15>
password=<text>
callbacknumber=<number>
callbacktype=<text>
Use the omconfig rac authentication command to specify whether you want to enable local operating system authentication of a system that is seeking to use the remote access interface. To enable local operating system authentication, type:
omconfig rac localauthenable=true
To disable local operating system authentication, type:
omconfig rac localauthenable=false
Use the omconfig rac authentication command to determine whether local operating system authentication of users is enabled or disabled for the remote access controller.
The RAC has two methods of authenticating user access: RAC authentication and local operating system authentication. RAC authentication is always enabled. Administrators can set up specific user accounts and passwords that allow access to the RAC.
Operating systems also require administrators to define different levels of users and user accounts; each user level has different privileges. Local operating system authentication on the RAC is an option for administrators who do not want to define one set of privileges for users in the operating system and a separate set of users and accounts for the RAC. If you enable local operating system authentication for the RAC, you enable any user with Administrator status on the operating system to log into the RAC.
omconfig rac authentication localauthenable=true
you have configured the RAC to allow access to any user who has Administrator privileges on the operating system.
omconfig rac authentication localauthenable=false
you have configured the RAC to allow access only to users with user names and passwords that are defined by the RAC administrator.
|
NOTE: Some features documented may not be available on your system's RAC. For example, dial/up modem use is supported only on DRAC III. |
Use the omconfig rac dialinusers command to specify requirements for each user who is to have dial-in privileges. The administrator can specify values for a user name, password, and other properties for each user. Table 10-2 shows the valid parameters for the command.
Table 10-2. omconfig rac dialinusers
|
Name=value pair |
Description |
|---|---|
Set the user name for the point-to-point protocol (PPP) user. | |
The following example sets one name=value pair. Type:
omconfig rac dialinusers username=jdoe
The next example supplies values for all command parameters that you can use with the omconfig rac dialinusers command. Type:
omconfig rac dialinusers username=jdoe index=0 password= steven70 callbacknumber=4441022 callbacktype=present
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac dialoutusers command to specify requirements for each user who is to have dial-out privileges. The administrator can specify values for a surname, password, IP address, and other properties for each dial-out user. Table 10-3 shows the valid parameters for the command.
Table 10-3. omconfig rac dialoutusers
|
Name=value pair |
Description |
|---|---|
Set the IP address, which must be specified in dotted-decimal notation. | |
Set the user name for the point-to-point protocol (PPP) dial-out user. | |
The following example sets one name=value pair. Type:
omconfig rac dialoutusers ipaddr=14.16.53.18
The following message appears:
Command Successful. Please reset RAC card!
The next example supplies values for all command parameters that you can use with the omconfig rac dialoutusers command. Type:
omconfig rac dialoutusers ipaddr=14.16.53.18 index=1
username=sustein password=74chaunu phonenumber=4021027
authtype=any
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac generatecert command to generate the certificate signing request (CSR) that you send to a certificate authority (CA). A certificate authority is a business entity that is recognized in the IT industry for meeting high standards of reliable screening, identification, and other important security criteria. Examples of CAs include Thawte and VeriSign. After the CA receives your CSR, they review and verify the information the CSR contains. If the applicant meets the CA's security standards, the CA issues a certificate to the applicant that uniquely identifies that applicant for transactions over networks and on the Internet.
For the purposes of the RAC, you can use the omconfig rac generatecert command to generate a CSR. Then you send the CSR in your application to the CA; the CA approves the CSR and sends you a certificate. Then use the omconfig rac uploadcert command to upload the certificate to the RAC. Uploading your new certificate replaces the default RAC certificate that you received with your RAC.
|
NOTE: Whenever you have a fully qualified pathname or filename that contains spaces, you must place double quotation marks around the string. For example, if your update package is located at c:\security files\certificates\sslcert.cer, you must place the fully qualified path in double quotations because there is a space between "security" and "files." The following is an example command using the fully qualified path and filename enclosed in quotation marks. |
omconfig rac generatecert file="c:\security files\certificates\sslcert.cer"
|
NOTE: Except for the two-letter country code, all other parameter values are strings. Parameters are required only if indicated (required). |
Table 10-4 shows required and optional parameters that are used to generate your CSR.
Table 10-4. omconfig rac generatecert
|
Name=value pair |
Description |
|---|---|
City name or other location name where your system is located. | |
Once you have generated the CSR, you can upload the certificate to the RAC using the omconfig rac uploadcert command.
Use the omconfig rac modem command to configure properties for your RAC's modem, if present. Table 10-5 shows the valid parameters for the command.
Table 10-5. omconfig rac modem
|
Name=value pair |
Description |
|---|---|
Enter the modem speed in bits per second. The default baud rate is 38400. | |
Specify whether the dial type for your modem is tone or pulse. |
Use the omconfig rac network command to specify network parameter values. Table 10-6 shows the valid parameters for the command.
Table 10-6. omconfig rac network
The following example sets one name=value pair. Type:
omconfig rac remote ippaddr=123.169.555.216
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac snmptraps command to specify the SNMP trap property values. Table 10-7 shows the valid parameters for the command.
Table 10-7. omconfig rac snmptraps
|
Name=value pair |
Description |
|---|---|
Set the IP address, which must be specified in dotted-decimal notation. | |
Set the SNMP trap index. The index specifies one of the 16 trap "positions" on the RAC. | |
The following example sets one name=value pair. Type:
omconfig rac snmptraps ipaddr=123.166.555.216 index=1
The following message appears:
Command Successful. Please reset RAC card!
The next example supplies values for all command parameters that you can use with the omconfig rac smnptraps command. Type:
omconfig rac snmptraps ipaddr=123.166.555.216 index=0 trapsenable=true community=dell
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac remote command to specify the remote features property values. Table 10-8 shows the valid parameters for the command.
Table 10-8. omconfig rac remote
|
Name=value pair |
Description |
|---|---|
Set the directory path on the TFTP server where the firmware update images reside. |
The following example sets one name=value pair. Type:
omconfig rac remote floppytftpenable=true
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac rmdialinuser command to remove dial-in user properties. Table 10-9 shows the valid parameters for the command.
Table 10-9. omconfig rac rmdialinuser
|
Name=value pair |
Description |
|---|---|
The following example sets one name=value pair. Type:
omconfig rac rmdialinuser username=jdoe
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac rmdialoutuser command to remove dial-out user properties. Table 10-10 shows the valid parameters for the command.
Table 10-10. omconfig rac rmdialoutuser
|
Name=value pair |
Description |
|---|---|
The following example sets one name=value pair. Type:
omconfig rac rmdialoutuser username=jdoe
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac rmsnmptrap command to remove the SNMP trap properties. Table 10-11 shows the valid parameters for the command.
Table 10-11. omconfig rac rmsnmptrap
|
Name=value pair |
Description |
|---|---|
The following example sets one name=value pair. Type:
omconfig rac rmsnmptrap ipaddr=123.199.152.216
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac rmuser command to remove user properties. Table 10-12 shows the valid parameters for the command.
Table 10-12. omconfig rac rmuser
|
Name=value pair |
Description |
|---|---|
The following example sets one name=value pair. Type:
omconfig rac rmuser username=jdoe
The following message appears:
Command Successful. Please reset RAC card!
Use the omconfig rac reset command to reset the RAC.
Use the omconfig rac uploadcert command to upload the server or CA certificate to the RAC. You must enter the fully qualified pathname of the certificate and select the type of certificate to upload. The two types of certificate that you can upload are a server certificate, or a certificate that you can obtain from a certificate authority (CA). Examples of certificate authorities are Thawte Server CA or VeriSign, Inc. Table 10-13 shows the valid parameters for the command.
Table 10-13. omconfig rac uploadcert
|
Name=value pair |
Description |
|---|---|
Indicate whether the certificate you are uploading is a server certificate or a CA certificate. |
Use the omconfig rac users command to specify user property values. Table 10-14 shows the valid parameters for the command.
Table 10-14. omconfig rac users
|
Name=value pair |
Description |
|---|---|
Specify the index of the entry. The index specifies one of the 16 user "positions" on the RAC. | |
The following example sets one name=value pair. Type:
omconfig rac users username=jdoe
The following message appears:
Command Successful. Please reset RAC card!