Step 1: Configure WebSphere

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

To Configure WebSphere for Identity Manager

Before You Begin

You should have a WebSphere application server and servlet engine installed.

1. Create a staging directory and name it idm_staging.

2. Copy the idm.war file from the base directory of the installation media to the idm_staging directory.

3. Unjar the idm.war file in the idm_staging directory:

   jar -xvf idm.war

4. Set the environment variables JAVA_HOME and WSHOME. For example, in Windows do the following:

   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.

   ---

5. If you plan to use a 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 Appendix C, Database Reference. When finished, launch setup to continue with installation.

   ---

   Note –

   If you launch setup before copying your 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.

   ---

6. If you plan to use the Identity Manager Service Provider feature and you are using the IBM 1.5 JDK (or later), set the following properties:

   1. In the was-install/java/jre/lib directory, rename the jaxb.properties.sample to jax.properties and uncomment these two lines:

      javax.xml.parsers,SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl

      javax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl

   2. Save the file and restart the application server.