The regadm command can be used to configure Auto Registration, as well as view configuration details. Note that certain configuration tasks, for example, authentication, must be performed prior to registering your system. For more information, see Tasks That Are Required Prior to Registration.
Table 17–2 Configuring Auto Registration Properties (Task Map)
Task |
Instructions |
For Information |
---|---|---|
Display the current Auto Registration configuration. |
Use the regadm list command to display the current Auto Registration configuration. User account credentials, as well as network connectivity information, is displayed by using this command. | |
Clear the current Auto Registration configuration. |
Use the regadm clear command to reset the current Auto Registration configuration. Note that all properties are cleared during this process. | |
Configure HTTP proxy and port settings. |
Use the regadm set command to configure network connectivity information. | |
Configure HTTP proxy authentication settings. |
Use the regadm set command to also configure HTTP proxy authentication settings, per your site's policy and requirements. | |
Authenticate a specific user or account with My Oracle Support by specifying named credentials. |
Use the regadm auth command if you want to associate a registered system with a specific user or account. |
How to Authenticate a User by Specifying Named Support Credentials |
The process of registering your system by using the regadm command includes gathering information and performing certain tasks prior to registration. The task flow is as follows:
Configure HTTP proxy information, per site policy, if required.
Configure HTTP proxy authentication information, per site policy, if required.
For information about how to configure HTTP proxy settings, see Configuring Auto Registration Properties.
Select a registration method.
You can register in one of two ways, by specifying named support credentials or anonymously:
If you want to register by specifying My Oracle Support credentials or by using a Sun Online account, you must provide those support credentials prior to registration. For instructions, see How to Authenticate a User by Specifying Named Support Credentials.
If you are registering anonymously, you can proceed with the registration. See How to Register Your System by Using the regadm Command.
To display the currently authenticated user name and network connectivity information, use the regadm list command, as follows:
# regadm list |
If you need to reset all of the property settings for a configuration, use the regadm clear command. For information, see How to Clear the Current Auto Registration Configuration.
Following are a few examples of various types of Auto Registration configurations.
# regadm list My Oracle Support username user@example.com HTTP Proxy <not configured> HTTP proxy port <not configured> HTTP proxy user <not configured> HTTP proxy password <not configured> |
# regadm list My Oracle Support username user@example.com HTTP Proxy webproxy.example.com HTTP proxy port 8080 HTTP proxy user <not configured> HTTP proxy password <not configured> |
# regadm list My Oracle Support username user@example.com HTTP Proxy webproxy.example.com HTTP proxy port 8080 HTTP proxy user webuser HTTP proxy password ****** |
Clearing the current configuration sets all of the Auto Registration properties to their default settings. This operation essentially has the same effect as a factory reset.
Become superuser or assume an equivalent role.
List the current Auto Registration configuration.
# regadm list |
Clear the current Auto Registration configuration.
# regadm clear |
Verify that the current configuration was cleared.
# regadm list |
The output now displays the default settings for all property values. The default property values are not configured.
In the following example, the regadm clear command is used to clear the property values of the current Auto Registration configuration.
# regadm list My Oracle Support username user@example.com HTTP Proxy webproxy.example.com HTTP proxy port 8080 HTTP proxy user webuser HTTP proxy password ****** # regadm clear # regadm list My Oracle Support username <not configured> HTTP Proxy <not configured> HTTP proxy port <not configured> HTTP proxy user <not configured> HTTP proxy password <not configured> |
The following Auto Registration properties can be configured by using the regadm command:
My Oracle Support or Sun Online account user name and password (Optional)
The user name and password can be configured by using the regadm auth command. The command can be run in either interactive or non-interactive mode. For instructions, see How to Authenticate a User by Specifying Named Support Credentials.
HTTP proxy name (Optional)
HTTP proxy port (Optional)
By default, a direct network connection is used during the registration process, unless you specify otherwise prior to registering. You can optionally configure HTTP proxy and port settings by using the regadm set command. For instructions, see How to Configure HTTP Proxy and Port Settings.
To determine the HTTP proxy name and port information to use, check with your site administrator. To determine whether you need to specify HTTP proxy authentication information, check the policy that is implemented at your site.
HTTP proxy user name and password for authentication (Required only if HTTP proxy authentication is implemented at your site)
If your site's policy specifies that you must set an HTTP proxy user name and password, you can configure this property prior to registration by using the regadm set command. For instructions, see How to Configure HTTP Proxy Authentication Settings.
Previously configured HTTP proxy and port settings can be changed or reset to a direct network connection by using the regadm clear command. For instructions, see How to Clear the Current Auto Registration Configuration.
If you previously registered your system by using a direct network connection, or if you are performing a new registration, you might need to configure HTTP proxy and port settings prior to registering your system.
Become superuser or assume an equivalent role.
Set the HTTP proxy.
# regadm set -n http_proxy -v webproxy-host |
The web proxy might be an IP address, a non-fully-qualified host name, or a fully-qualified host name.
Set the HTTP port.
# regadm set -n http_port -v port-number |
If your site implements HTTP proxy authentication, you must also configure HTTP proxy authentication settings (user name and password). The password must be specified as a single line in a text file and then passed to the regadm command. The following procedure describes how to protect the password file while it is in use. This file should be removed immediately after running the regadm command.
The regadm command accepts a password file in two cases:
When you are setting a user name and password by using the regadm auth command.
When you are setting the HTTP proxy user name and password by using the regadm set command.
Become superuser or assume an equivalent role.
Set the HTTP proxy user name.
# regadm set -n http_proxy_user -v webuser |
where webuser is the site-supplied value to use for authenticating a user with the HTTP proxy server.
Create a temporary password file.
# touch pwfile |
Secure permissions on the file.
# chmod 600 pwfile |
Using a text editor, edit the temporary password file to insert a one-line entry that contains your password information.
Set the HTTP password authentication information.
# regadm set -n http_proxy_pw -v pwfile |
where pwfile is the password file that you created in Step 3.
Remove the password file.
# rm pwfile |
The following example shows how to configure the HTTP authentication properties for a site that requires an HTTP user name and password for authentication purposes.
# regadm set -n http_proxy_user -v webuser # touch myhttppasswd # chmod 600 myhttppasswd # vi myhttppasswd . . . # regadm set -n http_proxy_pw -v myhttppasswd # rm myhttppasswd |
To switch network connectivity to a direct connection, you must set all of the HTTP proxy settings to a null value (not configured), as shown in the following example:
# regadm set -n http_proxy "" # regadm set -n http_proxy_port "" # regadm set -n http_proxy_user "" # regadm set -n http_proxy_pw "" # regadm list My Oracle Support username <not configured> HTTP Proxy <not configured> HTTP proxy port <not configured> HTTP proxy user <not configured> HTTP proxy password <not configured> |
Before a system's products can be registered, the user or account must be authenticated by specifying valid My Oracle Support credentials or valid Sun Online account credentials. If no support credentials are provided, the system is registered with an anonymous My Oracle Support account. You can use the regadm command with the auth subcommand, either interactively or non-interactively, to authenticate yourself with the Oracle Product Registration System.
Authentication must take place prior to registering by using the regadm register command.
The regadm auth command is used with the -u and -p options, as follows:
# regadm auth -u username -p pwfile |
The -u option specifies a valid user name. The -p option specifies a file that contains password information for the user account.
The password file is a single-line file that you create and then add the credentials that are to be passed to the regadm command. The contents of the password file are private. For security reasons, remove the file immediately after the information is passed to the regadm command and a successful authentication has occurred.
A successful authentication persists across reboots and only needs to be provided one time. You can authenticate before or during an installation, or after an installation by using the regadm auth command. The password is never stored on the system. Only an opaque token is maintained after a successful authentication.
The regadm auth command can be used to authenticate a user with My Oracle Support, either interactively or non-interactively. The following procedure describes how to use the command non-interactively. The examples that follow show how to run the command in both modes.
Become superuser or assume an equivalent role.
Create a temporary password file:
# touch pwfile |
Secure permissions on the file:
# chmod 600 pwfile |
Using a text editor, edit the temporary password file that you just created. Insert a one-line entry that contains your password information.
Authenticate with My Oracle Support by specifying your named support credentials:
# regadm auth -u user@example.com -p pwfile |
where user@example.com is either the My Oracle Support or Sun Online account user name, and pwfile is the password file that you created in Step 2.
A message indicating that the authentication succeeded or failed is displayed.
Proceed as follows:
If the authentication succeeds, you can proceed with the registration.
For instructions, see How to Register Your System by Using the regadm Command.
If the authentication fails, refer to Troubleshooting Auto Registration Issues.
Remove the temporary password file:
# rm pwfile |
# touch mospwfile # chmod 600 mospwfile # vi mospwfile . . . # regadm auth -u jdoe@mycompany.com -p mospwfile Authenticating "jdoe@mycompany.com" with My Oracle Support Authentication sucessful You can now register this system with My Oracle Support via "regadm register" # rm mospwfile |
# regadm auth Enter your My Oracle Support username: jdoe@mycompany.com Enter password: Enter password again: Authenticating "jdoe@mycompany.com" with My Oracle Support Authentication successful You can now register this system with My Oracle Support via "regadm register" |