Sun Java logo     Previous      Contents      Next     

Sun logo
Sun Java[tm] System Identity Manager Quick Start Guide 

Chapter 3
Installing and Configuring Identity Manager

This chapter provides general instructions for installing an evaluation copy of Identity Manager.

The information is organized into the following sections:

Installing Identity Manager

Use the following steps to install and configure Identity Manager:

  1. Unzip the Identity Manager installation zip file to access the Identity Manager installation files.
  2. Enter the install command to launch the Identity Manager installer graphical user interface.

  3. Note

    You can run the installer in nodisplay mode on Unix systems; however, additional steps are necessary and they will not be covered in this Quick Start Scenario. For more information, see Sun Java™ System Identity Manager Installation.

  4. When the Welcome panel displays, click Next.
  5. The installer displays the Install or Upgrade? panel.

  6. Leave the New Installation option selected and click Next.
  7. The installer displays the Select Installation Directory panel.

  8. If necessary, replace the displayed directory location with the location where you want to install Identity Manager.
  9. Enter (or click Browse to locate) a staging location or a specific folder, and then click Next.


    • Unless you plan to create a new context (virtual directory) in Tomcat's server.xml directory, we recommend installing to
    • %TOMCAT_HOME%\webapps\idm

    • If the directory you entered does not yet exist, the installer prompts for confirmation, and then creates the directory.

  10. Click Next to begin installation.
  11. After installing files, the installer displays the Launch Setup panel.


    Before continuing, if you plan to use an index database, you may need to copy one or more files to the idm\WEB-INF\lib directory.

    For example, copy the MySQL Connection/J jar file into <IDM_HOME>WEB-INF/lib before launching the Setup Wizard.

    Depending on the version, the required jar file name will be something similar to:


    You can download this file from:

    To determine which steps you may have to perform before you go on, see Appendix A, Index Database Reference in the Sun Java™ System Identity Manager Installation.

    If you click Launch Setup before copying your index database files, setup will not proceed correctly. If this happens, quit the installation program, and then use the lh setup command to restart the set-up portion of the installation process.

    When you are finished copying your index database files (or if you are not going to use an index database) proceed to Step 7 to continue the set-up process.

  12. Click Launch Setup to launch the Setup Wizard.
  13. Click Next on the Setup Wizard panel.
  14. When the Locate the Repository panel displays, select the MySQL JDBC Driver index database from the menu. Accept all of the defaults (except for the database user password if you changed it in Step b of Setting Up MySQL).

  15. Note

    See Appendix A, Index Database Reference in the Sun Java™ System Identity Manager Installation for selection information and set-up instructions.

  16. Click Next.
  17. When the installer displays the Free Use License, which enables you to run the demonstration version of Identity Manager, click Next to accept.
  18. Click Next to complete the installation process, and continue to the next section for configuration instructions.

Configuring Identity Manager

Use the following instructions to configure Identity Manager for the Quick Start Scenario:

  1. Select Yes on the Setup Demo? page of the Setup Wizard to continue configuring Identity Manager for the Quick Start Scenario.
  2. Enter information about yourself on the Demo User Information page.
  3. Specify which type of server to manage in the Demo Scenario on the Demo Environment page:
    • Active Directory
    • LDAP
    • Red Hat Linux
    • Solaris
  4. Enter the hostname of an SMTP server to use for sending notifications in Identity Manager.

  5. Note

    • If an SMTP server is not available, you can enter a path to a Notification File to which all email sent by Identity Manager will be written.
    • Some application servers require mail.jar and activation.jar files to be included in the shared classpath directory.

  6. Click Test Server to verify that the information about the server is valid.
    • If the server information is valid, you will see the following message:
      Successfully connected to <smtp host> for SMTP.
    • If the information is not valid, an error message displays.
  7. Enter information about the selected resource on the Resource Configuration page.
  8. Identity Manager uses this information to manage users on the resource.

  9. Click Test Configuration button to test your configuration settings.

  10. Note

    You can view any failure messages by clicking the Details button.

  11. Click Next.
  12. When the Save Configuration page displays, click Execute to save the information you provided in the Setup Wizard.
  13. Stop and restart Tomcat.

  14. Note

    When the installation is complete, Identity Manager displays the Installation Summary panel. For detailed information about the installation, click Details.

    Depending on the amount of information captured during the installation process, not all messages may be displayed here. View the log file (identified in details) for more information.

  15. When finished, click Close to exit the installer.

Identity Manager is now ready to run the Quick Start Scenario.

Install Sun Identity Manager Gateway

To install Sun Identity Manager Gateway:

  1. Select the Windows machine on which to install the gateway.

  2. Note

    The machine must be a member of the domain in which the accounts and other objects will be managed (managed domain) or a domain member that is trusted by the managed domain. The gateway does not have to run on a domain controller.


    For better performance, locate the gateway near (from a network connectivity perspective) the managed domain’s domain controllers.

  3. If you selected a system that is not the Identity Manager server; create a directory called idm on the remote system, copy the file from the Identity Manager Installation CD, and then unpack and copy the contents of the file to the idm directory.
  4. To install the gateway as a service, run the gateway –i command from the directory where the gateway files are installed:
  5. Run the gateway -s command to start the gateway service:

  6. Note

    • To stop the gateway service, run the gateway -k command:
    • When you are working with the gateway, the following failure messages (and probable causes) may occur:
      • 'Overlapped I/O operation is in progress'

        The most common cause of this message is that you asked for the service to be installed or removed before a prior installation or removal has fully completed. Check the state of the service.

      • 'Input/output error'

        The most common cause of this message is that you do not have rights to work with this service.

You are finished installing the Sun Identity Manager Gateway. Continue to Chapter 4, "Quick Start Scenario."

Previous      Contents      Next     

Part No: 819-7564-10.   Copyright 2006 Sun Microsystems, Inc. All rights reserved.