Use the following procedure to prepare the application server for Identity Manager:
You should have a WebSphere application server and servlet engine installed.
Create a staging directory and name it idm_staging.
Copy the idm.war file from the base directory of the installation media to the idm_staging directory.
Unjar the idm.war file in the idm_staging directory:
jar -xvf idm.war
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
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.
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.
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.
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:
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
Save the file and restart the application server.