Registering Your System by Using the regadm Command

How to Display Registration Information About Products Not Yet Registered

Using the dry run function of the regadm register command enables you to display service tag information about products that are not yet registered. This function can be useful for system administrators who want to know what information will be sent to My Oracle Support prior to actually registering. Service tags enable automatic discovery of the products that are installed on your system. When you use the register -d command option, the service tag data that is to be transmitted to the Oracle Product Registration System is merely displayed.

To use the dry run command option you must be on a system that has network connectivity.

1. Become superuser or assume an equivalent role.

2. Type the regadm register command with the dry run command option, as follows:

   # regadm register -d

   The output of the command is displayed in XML file format.

Example 17–9 Displaying Registration Information About Products Not Yet Registered

The following example shows the output from running the regadm register command with the -d option. For brevity, the command output has been truncated.

# regadm register -d
Registering with My Oracle Support using username user@example.com
<?xml version="1.0"?>
<st1:request>
	<agent>
	<agent_urn>urn:st:5eabd994-12d0-6c6c-bf6e-a2cca89a0287</agent_urn>
	<agent_version>1.1.5.</agent_version>
	<registry_version>1.1.5</registry_version>
	<system_info>
		<system>SunOS</system>
		<host>hs-t1000-1</host>
		<release>5.10</release>
		<architecture>sparc</architecture>
		<platform>SUNW,Sun-Fire-T1000::Generic_141444-09</platform>
		.
		.
		.
	<system_info>
	</agent>
</st1:request>

<?xml version="1.0"?>
<st1:request>
	<service_tag>
		<instance_urn>urn:st:fd96de223-e190-6501-ff8d-dd76f1b708f5</instance_urn>
		<product_name>Solaris 10 Operating System</product_name>
.
.
.
	

How to Register Your System by Using the regadm Command

The regadm register command is used to register each product in the Service Tag Registry with My Oracle Support. Registration is accomplished by using the current authentication credentials. If no credentials are provided, the registration is performed anonymously by using an anonymous My Oracle Support account.

Before You Begin

Be sure to check Tasks That Are Required Prior to Registration for prerequisite instructions.

Consider also the following information:

• If you previously registered your system anonymously, and you now want to register by specifying named support credentials, you must authenticate those credentials by using the regadm auth command. The process of authentication is a separate task that must be performed prior to registration. For instructions, see How to Authenticate a User by Specifying Named Support Credentials.

• If you previously registered your system by specifying named support credentials, and you now want to register anonymously, you must clear the current Auto Registration configuration prior to registration. For instructions, see How to Clear the Current Auto Registration Configuration.

  ---

  Note –

  The clear subcommand clears all configured properties, including any previously configured network connectivity information.

  ---

• If you previously registered your system by using a direct network connection, and you now want to specify HTTP proxy and port information, you must configure those properties by using the regadm set command prior to registration. For instructions, see How to Configure HTTP Proxy and Port Settings.

1. Become superuser or assume an equivalent role.

2. List the current Auto Registration configuration.

   # regadm list

   If the output of the regadm list command does not display any configured Auto Registration properties (user name), the registration will be anonymous. Otherwise, the registration is associated with the user name that is displayed. If you are registering your system anonymously, but you prefer to provide support credentials, see How to Authenticate a User by Specifying Named Support Credentials before proceeding.

   If the output of the regadm list command does not display any HTTP proxy or port information, the registration will be performed by using a direct network connection. Otherwise, the existing HTTP property settings are used. If you need to reconfigure Auto Registration properties for network connectivity, see How to Configure HTTP Proxy and Port Settings before proceeding.

3. Register your system.

   # regadm register

   ---

   Note –

   The output of the regadm register command varies, depending on how the Auto Registration feature is configured on your system.

   ---

Example 17–10 Registering Your System Anonymously

The following example shows an anonymous registration on a system where no named support credentials were configured prior to registration. The registration also uses a direct network connection.

# 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>
# regadm register
Registered Solaris 10 Operating System
Registration Successful

Example 17–11 Registering Your System by Specifying Named Support Credentials

The following example shows a registration on a system where support credentials and HTTP proxy and port information were configured prior to registration.

# 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 register
Registering with My Oracle Support using username user@example.com
Registered Solaris 10 Operating System
Registration successful

Obtaining Information About Currently Registered Products

To obtain service tag information for products that are currently registered with the Auto Registration feature, go to https://inventory.sun.com/inventory/data.jsp.

To access service tag information for your registered products, you must first log in with either your My Oracle Support account credentials or your Sun Online account credentials.

Be aware that the inventory web site provides information about discovery and registration methods that are not associated with the new Auto Registration feature. These other registration methods are used on a voluntary basis and registration is not mandatory. If you have installed Oracle Solaris 10 9/10, Auto Registration occurs upon the first reboot after an installation or upgrade.

For general information about how your system's assets are managed with service tags, go to http://wikis.sun.com/display/ServiceTag/Home.