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.
Note - To use the dry run command option you must be on a system that has network connectivity.
# 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 firstname.lastname@example.org <?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> . . .
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.
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.
# 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.
# 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
# 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
# regadm list My Oracle Support username email@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 firstname.lastname@example.org Registered Solaris 10 Operating System Registration successful
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.
Note - 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.