Customizing the context root (Software stack )

Edit online

You can customize the context root of Identity Manager Service Center.

About this task

This procedure describes how you can customize the context root of Identity Manager Service Center. By default the context root is /itim/ui. You can customize this context root to be, for example, /custom/ui.
Important: After you migrate from a previous fix pack version to the next fix pack version, the Identity Manager Service Center URL context root customization reverts back to the original values for the Identity Manager Service Center user interface and help. However, the Identity Manager Service Center subform URL customization is not affected. Hence, you must specify the URL context root customization values again for the Identity Manager Service Center user interface and help after migration.

Procedure

  1. Log on to the WebSphere Application Server console with administrator credentials.
  2. Go to Applications > Application Types > Business-level applications.
  3. Click IdentityServiceCenterApplication.
  4. Click com.ibm.icim_CU.eba.
  5. Under Additional Properties, click Context root for web modules.
  6. Update the context root mapping for com.ibm.isim.ui with your custom context root.

    For example, if you update com.ibm.isim.ui from /itim/ui to /custom/ui, the Identity Manager Service Center URL becomes https://hostname:port/custom/ui.

  7. Customize the mapping for com.ibm.isim.ui.help with your custom context root.
    For example: /custom/uihelp.
    Note: If you update com.ibm.isim.ui.help, you must also update the helpBaseUrl property in the UIHelp.properties file. The custom settings for this property must match the settings that you specify for com.ibm.isim.ui.help in the WebSphere Application Server console.
    1. Copy the .../itim/custom/ui/original/config/UIHelp.properties file to the .../itim/custom/ui/config folder.
    2. Open the .../itim/custom/ui/config/UIHelp.properties file in a text editor and update the helpBaseUrl property with your custom settings.
    3. Save and close the UIHelp.properties file.
    For more information, see Redirecting help content.
  8. In the WebSphere Application Server console, click OK to save changes.
  9. Go to Applications > Application Types > Business-level applications.
  10. Select IdentityServiceCenterApplication and restart the application.
  11. Go to Applications > Application Types > WebSphere enterprise applications > ITIM > Context Root For Web Modules.
  12. Update the context root mapping for isim_isc_subform with your custom context root.

    For example: custom/ui/subforms.

    Note: The following requirement must be met when you customize the context root for subforms:

    You must use the same context root that you set for com.ibm.isim.ui and then append /subforms. For example, if you customized the context root for com.ibm.isim.ui to /custom/ui, then for isim_isc_subform the context root should be /custom/ui/subforms.

  13. In the WebSphere Application Server console, click OK to save changes.
  14. Go to Applications > Application Types > WebSphere enterprise applications.
  15. Select ITIM and restart the application.