1. Oracle Solaris Management Tools (Road Map)
2. Working With the Solaris Management Console (Tasks)
3. Working With the Oracle Java Web Console (Tasks)
4. Managing User Accounts and Groups (Overview)
5. Managing User Accounts and Groups (Tasks)
6. Managing Client-Server Support (Overview)
7. Managing Diskless Clients (Tasks)
8. Introduction to Shutting Down and Booting a System
9. Shutting Down and Booting a System (Overview)
10. Shutting Down a System (Tasks)
11. Modifying Oracle Solaris Boot Behavior (Tasks)
12. Booting an Oracle Solaris System (Tasks)
13. Managing the Oracle Solaris Boot Archives (Tasks)
14. Troubleshooting Booting an Oracle Solaris System (Tasks)
15. x86: GRUB Based Booting (Reference)
16. x86: Booting a System That Does Not Implement GRUB (Tasks)
17. Working With the Oracle Solaris Auto Registration regadm Command (Tasks)
Oracle Solaris Auto Registration (Overview)
How Your Oracle Solaris 10 9/10 System Is Registered
When and How Service Tag Data Is Transmitted
Managing Auto Registration Configuration
How the Auto Registration Process Works
Getting Started With the regadm Command
When to Use the regadm Command-Line Interface
Requirements for Using the regadm Command
Managing the Auto Registration SMF Service
How to Determine If the Auto Registration SMF Service Is Enabled
How to Disable the Auto Registration SMF Service
How to Enable the Auto Registration SMF Service
Configuring the Auto Registration Feature by Using the regadm Command
Tasks That Are Required Prior to Registration
Displaying the Current Auto Registration Configuration
How to Clear the Current Auto Registration Configuration
Configuring Auto Registration Properties
How to Configure HTTP Proxy and Port Settings
How to Configure HTTP Proxy Authentication Settings
Authenticating a User by Specifying Named Support Credentials
How to Authenticate a User by Specifying Named Support Credentials
Registering Your System by Using the regadm Command
How to Display Registration Information About Products Not Yet Registered
How to Register Your System by Using the regadm Command
Obtaining Information About Currently Registered Products
Troubleshooting Auto Registration Issues
Cannot Send HTTP Proxy Password
18. Managing Services (Overview)
20. Managing Software (Overview)
21. Managing Software With Oracle Solaris System Administration Tools (Tasks)
22. Managing Software by Using Oracle Solaris Package Commands (Tasks)
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)
|
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.
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 ******
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.
# regadm list
# regadm clear
# 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>
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.
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.
# 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.
# 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.
# 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.
# touch pwfile
# chmod 600 pwfile
# regadm set -n http_proxy_pw -v pwfile
where pwfile is the password file that you created in Step 3.
# 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>
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.
Note - 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.
Note - 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.
# touch pwfile
# chmod 600 pwfile
# 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.
For instructions, see How to Register Your System by Using the regadm Command.
# 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"