Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun[TM] Identity Manager 8.0 Installation Guide 

Chapter 5
Installing Identity Manager for WebSphere

Use the following information and procedures to install Identity Manager for use with the IBM WebSphere Application Server. This chapter includes:


Before You Begin

During installation, you will need to know:


Installation Steps

Follow these installation and configuration steps, located in this chapter and following chapters:

These procedures assume that you have set up an application server and servlet engine in WebSphere. For detailed information about installing and using WebSphere, refer to the Web page or reference information provided by the application server software provider.

Step 1: Prepare the Application Server

Use the following procedure to prepare the application server for Identity Manager:

  1. Copy the idm.war file from the base directory of the installation media to an idm_staging folder.
  2. Unjar the idm.war file in the idm_staging folder:
  3. jar -xvf idm.war

  4. Set the environment variables JAVA_HOME and WSHOME:
  5. set JAVA_HOME=c:\Program Files\WebSphere\AppServer\java
    set WSHOME=Path To IDMStaging Directory


    Note

    Make sure the value of the WSHOME environment variable does NOT contain the following:

    • Quotation marks (“ “)
    • A slash or backslash at the end of the path (/ or \)

    Do not use quotation marks, even if the path to the application deployment directory contains spaces.


  6. If you plan to use an index database, you may need to copy one or more files to the idm\WEB-INF\lib directory. To determine the steps you may need to perform before you go on, see Index Database Reference. When finished, launch setup to continue with installation.

  7. Caution

    If you launch setup before copying your index database files, setup will not proceed correctly. Copy the files, and then use the lh setup command to restart the setup portion of the installation process.


Step 2: Install the Identity Manager Software

Use the following procedure to install Identity Manager on the application server.

  1. You may install the software using one of two methods:
    • Using the installer Graphic User Interface

      Run the install.bat (for Windows) or install (for UNIX) command to launch the installation process.

      If you copy the files from the installation media to your own location, note that the idm.war and install.class files must be in the same directory.

      The installer displays the Welcome panel.

    • Using the nodisplay option (UNIX only)

      Change directory to the Identity Manager software location. Enter the following command to activate the installer in nodisplay mode:

      install -nodisplay

      The installer displays the Welcome text. The installer then presents a list of questions to gather installation information in the same order as the Graphic User Interface installer in these procedures.


      Note

      If no display is present, the installer defaults to the nodisplay option. The DISPLAY environment variable must be set to a valid X server or the installation may fail.


  2. Click Next to display the Install or Upgrade? panel.
  3. Leave the New Installation option selected, and then click Next.
  4. The installer displays the Select Installation Directory panel.

  5. Replace the displayed directory location with the location where you want to install Identity Manager. This could be a staging location or a specific folder. Enter the location (or click Browse to locate it), and then click Next.
  6. Click Next to begin installation.
  7. After installing files, the installer displays the Launch Setup panel.

  8. Select an index database frm the list provided. Depending on your selection, setup prompts for additional setup information.

  9. Caution

    Before you continue, 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, you may need to place a JAR file containing a JDBC driver (for a DriverManager connection) or a JAR file containing a JNDI InitialContextFactory (for a DataSource connection). To determine the steps you may need to perform before you go on, see Index Database Reference. If you are planning to use a Data Source as your repository location, see the special instructions in Configuring Data Sources for Identity Manager.

    When finished, click Launch Setup to launch the Setup Wizard and continue with setup steps.

    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 setup portion of the installation process.


  10. Click Next on the Setup Wizard panel.
  11. The product displays the Locate the Repository panel.

  12. Select an index database from the list of displayed options.
  13. Depending on your selection, setup prompts for additional setup information.


    Note

    See Index Database Reference, for selections and setup instructions.


  14. Click Next.
  15. The Continue Identity Manager Demo Setup? panel appears.
  16. If this is a non-demo installation, click No, I will configure Identity Manager myself. Go to Step 20.
  17. If appropriate, click Yes, I would like to continue setting up a demonstration environment.
  18. This allows you to quickly configure users and enter environment and server information.

  19. Enter the following personal information:
    • First name
    • Last name
    • Email address

    • Note

      This personal information is used to create the Approver user (with configurator privileges.)


  20. Enter the following Approver information:
    • Approver name
    • Approver password
  21. Click Next.
  22. Select the Server Type from the list.
  23. Select None if your environment has no server to manage. If there is a server you wish to manage, select the appropriate server type. You will be prompted for further server information as appropriate.

  24. If you have an email SMTP server, click SMTP Host and enter the server address. If desired, click Test Server to verify communication to the SMTP server.
  25. If you would like email notifications to be written to a file, click Notification File. Click Browse to select another notification file.
  26. Click Next.
  27. The installer displays the Import Save Configuration panel.
  28. Click Execute to perform all the listed functions. If desired, click Hide Details.
  29. When all functions complete, click Done in the setup panel.
  30. If the application server is installed on a UNIX machine, change directories to the $WSHOME/bin directory and run the following command to allow the scripts in this directory to be executed.
  31. chmod -R +x *

Step 3: Configure the Application Server

Use the following procedure to configure WebSphere.


Note

The following procedure uses the Integrated Solutions Console, Version 6.1. The configuration procedure may vary for other versions of the Integrated Solutions Console.


  1. Delete the following files, if they exist:
    • WEB-INF/lib/log.jar
    • WEB-INF/lib/j2ee.jar
    • WEB-INF/lib/ldap.jar
  2. Create a .war file from WSHOME:
  3. jar -cvf idm.war *

  4. Start the application server. You must use WebSphere’s script to do this. For example, if WebSphere’s binary files are installed in c:\Program Files\WebSphere\AppServer\bin, and that the application server is named server1:
  5. cd c:\Program Files\WebSphere\AppServer\bin

    startServer.bat server1

  6. Start the WebSphere Integrated Solutions Console, and then select
    Applications—>Install New Application. The Preparing for the application installation panel displays.
    1. Add the full path to the idm.war file in the Local or Remote file system field.
    2. Add the path to the Context Root for the Identity Manager installation (for example, /idm).
    3. Select the Show me all installation options and parameters option. Then click Next. A new panel is displayed.
  7. Select the Generate Default Bindings option. (Use the default selections for Override and Virtual Host.) Click Next.
  8. Accept the was.policy file that is displayed under the heading Application Security Warnings. Scroll down to the bottom of this file and click the Continue button.
  9. Configure the Step 1: Select installation options page as needed.
    • If you want to install the application to a different location than WebSphere’s default location, enter the path to install the application in the Directory to Install Application field; for example:

      c:\Program Files\WebSphere\AppServer\installedApps\Hostname

    • Make sure the Distribute Application and Use Binary Configuration options are selected.
    • Make sure that the Create Mbeans for Resources and Deploy Enterprise Beansoptions are not selected.
    • Enter the name of the application in the Application Name field (the default is idm).
    • If desired, select the Enable class reloading option.
    • Click Next after configuring this dialog.

  10. Make sure the Step 2: Map modules to servers panel displays a line for the current release of Identity Manager and that it maps to the appropriate serve. Click Step 6: Map virtual hosts for Web modules.
  11. Make sure the Step 6: Map virtual hosts for Web modules panel displays a line for the current release of Identity Manager and that it maps to the appropriate virtual host, and then click Step 8: Summary.
  12. Review the summary of options, then click Finish.
  13. After Identity Manager has been installed, click Save to Master Configuration to save the configuration.
  14. Click Save, and then wait for the page to clear.
  15. Stop the Identity Manager application.
  16. Add the following line to your WAS_ROOT/profiles//ProfileName//
    installedApps//
    nodename///EnterpriseAppName///idm.war/WEB-INF/
    ibm-web-ext.xmi
    file
  17. <jspAttributes xmi:id="JSPAttribute_1" name="jdkSourceLevel" value="15"/>

    This line causes the application server to compile JSP files in Java 5.

  18. Restart Identity Manager.

Step 4: Install the Sun Identity Manager Gateway

If you plan to set up Windows Active Directory, Novell NetWare, Domino, Remedy, or RSA ACE/Server resources, you should install the Sun Identity Manager Gateway. Follow the procedures in Install the Sun Identity Manager Gateway.



Previous      Contents      Index      Next     


Part No: 820-2956-10.   Copyright 2008 Sun Microsystems, Inc. All rights reserved.