A.0 Installing Identity Manager Home Using a Non-Default Context

If you specified a context other than the default IDMProv context when you installed the Roles Based Provisioning Module, the name of the main User Application .war file, which is IDMProv.war by default, matches the context. For example, if you specified the context IDMStartHere, the name of the file would be IDMStartHere.war.

When installing Identity Manager Home in an environment with a non-default context, you must perform the following additional steps:

  1. At a command prompt, navigate to the JBoss deploy directory. For example: /opt/novell/idm/jboss/server/IDMProv/deploy

  2. Rename the IDMProv.war file you copied from the Enhancement Pack to match the context name. For example, change the file name from IDMProv.war to IDMStartHere.war.

  3. Enter the following command:

    unzip IDMContext.war WEB-INF/web.xml

    Where IDMContext is the modified name of the IDMProv.war file.

  4. Use a text editor to open the WEB-INF/web.xml file.

  5. In the web.xml file, find the following entry:

    <display-name>IDMProv</display-name>

  6. Change the IDMProv value to match the context name, then save and close the file.

  7. At the command prompt, enter the following command:

    zip -u0 IDMContext.war WEB-INF/web.xml

  8. Enter the following command:

    unzip IDMContext.war WEB-INF/lib/IDMfw.jar

  9. Navigate to the WEB-INF/lib directory, the enter the following command:

    unzip IDMfw.jar PortalService-conf/config.xml

  10. Use a text editor to open the WEB-INF/lib/PortalService-conf/config.xml file.

  11. In the config.xml file, find the following entry:

    <key>portal.context</key>
<value>${portal.context:IDMProv}</value>

  12. Change the IDMProv value to match the context name, then save and close the file.

  13. In the command prompt window, go to the WEB-INF/lib directory and enter the following command:

    zip -u0 IDMfw.jar PortalService-conf/config.xml

  14. In the command prompt window, navigate to the deploy directory and enter the following command:

    zip -u0 IDMContext.war WEB-INF/lib/IDMfw.jar

  15. Delete the WEB-INF directory.

  16. Close the command prompt.