Registering Waveset

Administrators are encouraged to register their installation of Waveset.

You must have an Oracle Online Account and password to register. If you do not have an Oracle Online Account, you can register for one by completing the form at this address:

https://reg.sun.com/register

Waveset can be registered from the console or by using the Administrator interface.

Registering from the console allows you to also create a local service tag, which can be used with Sun Service Tag software to track your inventory of Oracle systems, software, and services. The service tags client package should be installed before you create a local service tag. This package can be downloaded by clicking the Download Service Tags button at the following address:

http://inventory.sun.com/inventory

To register Waveset, you must log on with an administrator account that allows you to configure Waveset objects. This account must have the Product Registration capability. For information about capabilities, see Assigning Capabilities to Users.

---

Note –

Java on your Waveset application servers must be properly configured for SSL for the product registration feature to work. All Jar files referenced in your java.security file (or equivalent) need to be present.

---

The rest of this section provides information and instructions to help you register Waveset. This information is organized into the following topics:

• Registering Waveset from the Console

• To Register Waveset from the Administrator Interface

Registering Waveset from the Console

You use the register command to register Waveset from the console. This section contains information about this command, including:

• register Command Usage

• register Command Options

• To Register Waveset from the Console

register Command Usage

register -local
register -remote [-u <userid> [-p <password>]] [-prompt] -userSOA <userid> 
-passSOA <password> [-proxy <proxyHost> [-port <proxyPortNumber>]] 
register [-help | -?]

register Command Options

The following table describes the options you can use with the register command.

Table 4–2 Command Options

Option	Description
-local	Create a service tag on this host.
-remote	Register this installation of Waveset over the network directly with Oracle.
-u <userid>	The Waveset user ID of the Waveset administrator who is authorized to do the registration.
-p <password>	The Waveset password of the Waveset administrator who is authorized to do the registration.
-prompt	Interactively prompt for the password if missing.
-userSOA <userid>	The user ID of the Oracle Online Account that will be used for registration. Required if registering with the -remote option.
-passSOA <password>	The password of the Oracle Online Account that will be used for registration. Required if registering with the -remote option.
-proxy <proxyHost>	The network proxy to use for access to the Oracle online registration service. Required if registering with the -remote option and your network is configured to use a proxy to reach external Internet addresses.
-port <proxyPortNumber>	The port on the network proxy to use for access to the Oracle online registration service. Required if registering with the -remote option and your network is configured to use a proxy to reach external Internet addresses.
-help | -?	Print help for this command to the console.

To Register Waveset from the Console

To register Waveset from the Console, you must create a local service tag or register with Oracle over the Internet. Use the following instructions:

1. Start the Waveset console (command-line) interface.

   • From a Windows command line, type

     %WSHOME%\bin\lh

   • From a UNIX command line, type

     $WSHOME/bin/lh

2. Use the register command to register Waveset.

   Use the following syntax:

   • To create a local service tag,

     register -local

   • To register Waveset over the Internet, use the following command:

     register -remote -u <userid> -p <password> -userSOA <soaUserid> -passSOA <soaPassword> -proxy <proxyHost> -port <proxyPortNumber>

     where:

     • userid is the Waveset userID of the Waveset administrator who is authorized to do the registration.

     • password is the Waveset password of the Waveset administrator who is authorized to do the registration.

     • soaUserid is the user ID of the Oracle Online Account that will be used for registration.

     • soaPassword is the password of the Oracle Online Account that will be used for registration.

     • proxyHost is the network proxy to use for access to the Oracle online registration service. Only required if your network is configured to use a proxy to reach external Internet addresses.

     • proxyPortNumber is the port on the network proxy to use for access to the Oracle online registration service. Only required if your network is configured to use a proxy to reach external Internet addresses.

To Register Waveset from the Administrator Interface

If you do not need to create a local service tag, register Waveset from the Administrator interface.

1. In the Administrator interface, click Configure.

2. In the secondary menu, click Product Registration.

   The Product Registration page opens.

3. Complete the form and click Register Now. Click the i-Helps for information about individual form fields.

   ---

   Note –

   • If your application server is not configured to allow outgoing SSL connections, you might see the following error message:

     Failed to register on Sun Connection server due to invalid Sun Online Account user/password.

     To resolve this issue, add the appropriate trusted root certificates to your application server’s keystore. Consult your application server’s documentation for details.

   • If old versions of xml-apis.jar and xercesImpl.jar are present in your application server’s classpath, you might see the following error message:

     java.lang.NoSuchMethodError:org.w3c.dom.Node.getTextContent()Ljava/lang/String;

     To resolve this problem, modify the classpath so that only the most recent versions of xml-apis.jar and xercesImpl.jar are present.

   ---