Configuring the Auto Registration Feature by Using the regadm Command

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)

Tasks That Are Required Prior to Registration

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:

1. Configure HTTP proxy information, per site policy, if required.

2. Configure HTTP proxy authentication information, per site policy, if required.

   For information about how to configure HTTP proxy settings, see Configuring Auto Registration Properties.

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

Displaying the Current Auto Registration Configuration

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.

Example 17-1 Authenticated User (No Proxy)

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

Example 17-2 Authenticated User (Open Proxy With No Authentication)

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

Example 17-3 Authenticated User (Proxy That Requires Authentication)

# 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             ******

How to Clear the Current Auto Registration Configuration

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.

1. Become superuser or assume an equivalent role.
2. List the current Auto Registration configuration.

   # regadm list

3. Clear the current Auto Registration configuration.

   # regadm clear

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

Example 17-4 Clearing the Current Auto Registration Configuration

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>

Configuring Auto Registration Properties

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.

  ---

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

How to Configure HTTP Proxy and Port Settings

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.

1. Become superuser or assume an equivalent role.
2. 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.

3. Set the HTTP port.

   # regadm set -n http_port -v port-number

How to Configure HTTP Proxy Authentication Settings

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.

1. Become superuser or assume an equivalent role.
2. 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.

3. Create a temporary password file.

   # touch pwfile

4. Secure permissions on the file.

   # chmod 600 pwfile

5. Using a text editor, edit the temporary password file to insert a one-line entry that contains your password information.
6. 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.

7. Remove the password file.

   # rm pwfile

Example 17-5 Configuring HTTP Proxy Authentication Settings

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

Example 17-6 Switching From an HTTP Proxy Network Configuration to a Direct Connection

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>

Authenticating a User by Specifying Named Support Credentials

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.

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.

How to Authenticate a User by Specifying Named Support Credentials

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.

1. Become superuser or assume an equivalent role.
2. Create a temporary password file:

   # touch pwfile

3. Secure permissions on the file:

   # chmod 600 pwfile

4. Using a text editor, edit the temporary password file that you just created. Insert a one-line entry that contains your password information.
5. 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.

6. 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.
7. Remove the temporary password file:

   # rm pwfile

Example 17-7 Authenticating a User With Named Support Credentials (Non-Interactive)

# 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

Example 17-8 Authenticating a User With Named Support Credentials (Interactive)

# 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"