Deploying Web Administration Tool in WebSphere Application Server

Edit online

If you want to manage applications on your computer with WebSphere® Application Server, you can deploy Web Administration Tool in WebSphere Application Server.

Before you begin

To deploy Web Administration Tool in WebSphere Application Server, you must meet the following requirements:
  1. Complete the installation of Web Administration Tool package for your operating system.
  2. Your computer must contain a supported version of WebSphere Application Server.

About this task

IBM® Security Verify Directory installation media includes Web Administration Tool. If your computer contains WebSphere Application Server, you can deploy Web Administration Tool in WebSphere Application Server. To deploy Web Administration Tool, you must deploy the IDSWebApp.war file that is in the idstools directory of the IBM Security Verify Directory installation location.

Method A:

Run deploy_IDSWebApp tool provided by IBM Security Verify Directory in the idstools directory of the IBM Security Verify Directory installation location. Use -p <WebSphere_Install_Location> option. This tool creates a WebSphere Application Server profile with name TDSWebAdminProfile and deploys IDSWebApp.war into that profile.

On AIX® and Linux™
deploy_IDSWebApp -p /opt/IBM/WebSphere/AppServer
On Windows ™
deploy_IDSWebApp.bat -p "C:\Program Files\IBM\WebSphere\AppServer"

Method B:

Procedure

  1. Create a WebSphere Application Server profile by using the manageprofiles script.
    For example, /opt/IBM/WebSphere/AppServer/bin/manageprofiles.sh -create -profileName AppSrv01 -nodeName <shorthostname>Node1 -hostName <fullhostname> -adminUserName wasadmin -adminPassword <admin_password> -cellName <shorthostname>Node01Cell -enableAdminSecurity true -serverName server1 -profilePath /opt/IBM/WebSphere/AppServer/profiles/AppSrv01 -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/default -applyPerfTuningSetting standard -enableService false
  2. Verify /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/AboutThisProfile.txt file to know the port numbers associated with the profile. 
    # cat /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/AboutThisProfile.txt
Application server environment to create: Application server
Location: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01
Disk space required: 200 MB
Profile name: AppSrv01
Make this profile the default: True
Node name: Node1
Host name: sdssl15t1
Enable administrative security (recommended): True
Administrative console port: 9060
Administrative console secure port: 9043
HTTP transport port: 9080
HTTPS transport port: 9443
Bootstrap port: 2809
SOAP connector port: 8880
Run application server as a service: False
Create a Web server definition: False
Performance tuning setting: Standard
  3. Start the profile: 
    /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/startServer.sh server1
  4. Use the URL http://hostname_WAS_server:9043/ibm/console (where 9043 is the admin console secure port) to log in the WebSphere Application Server Admin console.
    Substitute the hostname_WAS_server variable with the hostname or IP address of your computer on which WebSphere Application Server is installed. If you specified a custom port to access WebSphere Application Server Admin console, substitute the default port, 9043, with your port number.
  5. Enter the user ID such as wasadmin and the password of the user that are used during profile creation.
    The user must contain the required permission to run operations on WebSphere Application Server.
  6. On the left navigational pane, click Application > New Application.
  7. In the New Application page, click New Enterprise Application.
  8. In the Path to the new application page, choose one of the following options that are based on from where you accessed the WebSphere Application Server Admin console:
    • You can copy IDSWebApp.war file from idstools folder of the IBM Security Verify Directory installation location to the WebSphere Application Server profile's installableApps folder:
      # cp /opt/ibm/ldap/V10.0.3/idstools/IDSWebApp.war /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installableApps/
    • If you accessed the WebSphere Application Server Admin console from a local computer, select Local file system, and enter the path of the IDSWebApp.war file in the Full path field. You can also click Browse to specify the path.
    • If you accessed the WebSphere Application Server Admin console from a remote computer, select Remote file system, and enter the path of the IDSWebApp.war file in the Full path field. You can also click Browse to specify the path.
  9. In the How do you want to install the application page, select the Fast Path option and click Next.
  10. In the Select installation options page, the default options are selected.
  11. Click Next.
  12. In the Map modules to server page, you can map modules to the servers that are specified in the Clusters and servers field.
    1. Select the checkbox for the required module, and click Apply.
    2. After you complete the mapping, click Next.
  13. In the Map virtual hosts for Web modules page, you can map the web application to the specific virtual servers.
    If more virtual hosts exist, the server requires information about the WebSphere Application Server environment to select the right module. In this example, the default_host option is available for selection.
  14. Click Next.
  15. In the Map context roots for Web modules page, enter the context root as /IDSWebApp in the field.
  16. A summary with your selection is shown.
  17. Click Finish.
    It initiates the installation of your application. A summary of installation is shown.
  18. To save the changes to the primary configuration, click Save.
  19. On the left navigational pane, click Applications > Application Types > WebSphere enterprise applications.
  20. In the Enterprise Applications page, select the checkbox next to IDSWebApp_war, and click Start.
  21. Start Web Administration Tool.
  22. To access Web Administration Tool, open a browser and enter the following address: Use ports 12100, 12101 for profile that is created with Method A and use ports 9080, 9443 for default profile created by using manageprofile script.
    • For nonsecured access (HTTP), enter http://WAS_server_hostname:12100/IDSWebApp or http://WAS_server_hostname:9080/IDSWebApp.
    • For secured access (HTTPS), enter https://WAS_server_hostname:12101/IDSWebApp or https://WAS_server_hostname:9443/IDSWebApp
    The port, 12100(or 9080), is the default HTTP port for WebSphere Application Server, and port, 12101(or 9443), is the default HTTPS port. If these ports are not the configured port for your WebSphere Application Server, provide the appropriate port number.
    If Global or Administrative security is configured for WebSphere Application Server, then you must meet the following requirements:
    1. Deploy Web Administration Tool in WebSphere Application Server as a new profile.
    2. Configure SSL for Web Administration Tool.
    3. If it is not possible to deploy Web Administration Tool in a profile, add the directory server certificate to the truststore of the profile. For the server-client authentication, add the WebSphere Application Server profile certificate to the truststore of the directory server.