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>