Chapter 13 Registering Identity Manager with Sun

You are encouraged to register your installation of Identity Manager.

Registering Identity Manager

To register, you will need a Sun Online Account and password. If you do not have a Sun Online Account, you can register for one by completing the form at this address:

https://reg.sun.com/register

Identity Manager 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 Sun 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

In order to register Identity Manager, you should be logged on with an administrator account that allows you to configure Identity Manager objects. This account should have the Product Registration capability. For information about capabilities, see Assigning Capabilities to Users in Sun Identity Manager 8.1 Business Administrator’s Guide.

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

Registering Identity Manager from the Console

To Create a Local Service Tag or Register Identity Manager over the Internet with Sun

1. Go to the following directory:

   %WSHOME%\bin\lh (Windows)

   $WSHOME/bin/lh (UNIX)

2. To create a local service tag, use the following command:

   lh register -local

   To register Identity Manager over the Internet with Sun, use the following command:

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

   where:

   • userid is the Identity Manager userID of the Identity Manager administrator who is authorized to do the registration

   • password is the Identity Manager password of the Identity Manager administrator who is authorized to do the registration

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

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

   • domain is the domain (or team) that the Sun Online Account user belongs to and wishes to use for the registration.

   • proxyHost is the network proxy to use for access to the Sun 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 Sun online registration service. Only required if your network is configured to use a proxy to reach external Internet addresses

The register Command

Usage

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

Options

Use these options with the register command:

Registering Identity Manager from the Administrator Interface

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

To Register Identity Manager 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 may receive 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.

   ---

   ---

   Note –

   If old versions of xml-apis.jar and xercesImpl.jar are present in your application server’s classpath, you may receive 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.

   ---