Appendix I. Deploying the Web Administration Tool into WebSphere

Tivoli Directory Server 6.3 provides Embedded WebSphere Application Server as an application server for the Web Administration Tool. However, you can also use WebSphere as a Web application server for the Web Administration Tool. (For versions that are provided and supported, see IBM® Tivoli® Directory Server Version 6.3 System Requirements.)

WebSphere Application Server is the IBM runtime environment for Java-based applications. WebSphere Application Server V7.0 offers:

• Application server purpose
• Evolving Java application development standards
• Enhanced management
• Advanced tooling and extensions
• Broader integration

For more information on WebSphere Application Server version 7.0, see http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp.

Use the following instructions to install and deploy IBM Web Administration Tool into WebSphere.

1. Install WebSphere using the installation information provided with it, and make sure that it is running properly.
2. Install the Web Administration Tool using either the InstallShield GUI or the installation utility for your operating system. The file containing the Web Administration Tool is named IDSWebApp.war, and it is in the idstools subdirectory of the installation directory you specified during installation of Tivoli Directory Server.
3. Login to the WebSphere Admin console, the default URL is:

   http://<hostnameOfWASsystem>:9060/ibm/console

4. Enter the user ID and password of the user. This user should have sufficient permission to perform operations on WebSphere Application Server.
5. On the left navigational pane, expand Application and then click New Application.
6. From the New Application panel, click New Enterprise Application.
7. On the Path to the new application panel, do one of the following depending from where the WebSphere Admin console is launched:
   • If from the local system, select Local file system and then enter the path of the IDSWebApp.war file in the Full path field. You can also click Browse to specify the path.
   • If from a remote system, select Remote file system and then enter the path of the IDSWebApp.war file in the Full path field. You can also click Browse to specify the path.
8. On the How do you want to install the application panel, select the option you want and click Next. In this example, the Fast Path option is selected.
9. On the Select installation options panel, the default options are selected. Click Next.
10. On the Map modules to server panel, user can map modules to the servers specified in the Clusters and servers field. Select the check box for the required module and then click Apply. After the mapping is done, click Next.
11. On the Map virtual hosts for Web modules panel, user can map the Web application to the specific virtual servers. If there are more virtual hosts, it requires knowledge of the WebSphere environment to select the right module. In this example, there is only one default_host option is available for selection. Click Next.
12. On the Map context roots for Web modules, enter a context root in the field. For example, /IDSWebApp.
13. A summary of options you selected is displayed. Click Finish.
14. This initiates the installation of your application. A summary of installation is displayed.
15. To start the application, you must first save the changes to the master configuration. Click Save.
16. On the left navigational pane, expand Applications and then click WebSphere enterprise applications under Application Types.
17. To start the application, from the Enterprise Applications panel select the check box adjacent to IDSWebApp_war and click Start.
18. Start the Web Administration Tool (for example, through the Administrative Console).
19. Now to launch the Web Administration Tool from a Web browser, type the following address:
    • For HTTP, type:

      http://<localhost>:WAS_http_port/IDSWebApp

    • For HTTPS, type:

      https://<localhost>:WAS_https_port/IDSWebApp

    By default, the HTTP port is 9080, and the HTTPS port is 9443.

    The Tivoli Directory Server Web Administration login page window is displayed.

    Note:
    This address works only if you are running the browser on the computer on which the Web Administration Tool is installed. If the Web Administration Tool is installed on a different computer, replace localhost with the hostname or IP address of the computer where the Web Administration Tool is installed.

    If Global or Administrative security is turned on for Websphere Application Server and SSL must be enabled for the Web Administration Tool when deploying the Web Administration Tool into Websphere Application Server, user can use one of the following approaches:

    • Deploy the Web Administration Tool into a new profile.
    • If it is not possible to deploy the Web Administration Tool into a new profile, user must add the directory server's certificate to the profile's trust store. Additionally, for server-client authentication user must add the Websphere Application Server profile certificate to the directory server's trust store.

[ Top of Page | Previous Page | Next Page ]