IBM Support

IBM Security Directory Server V6.4 Support for WebSphere Application Server V9.0.5

How To


Summary

How to install WebSphere Application Server V9.0.5 (latest recommended fix pack) to use with Web Administration Tool provided by IBM Security Directory Server V6.4.

Objective

This document describes installation procedures for WebSphere Application Server V9.0.5 (latest recommended fix pack) to use with Web Administration Tool provided by IBM Security Directory Server V6.4.

Environment

Security Directory Server V6.4
WebSphere Application Server 9.0.5

Steps

To deploy Web Administration Tool, you must complete the installation of WebSphere® Application Server 9.0.5 (latest Fix Pack) on your computer. The Web Administration Tool provides a graphical user interface for configuring IBM® Security Directory Server.
Here is the procedure for installing WebSphere Application Server 9.0.5 (or later fix pack):
  1. Download necessary part for WebSphere Application Server 9.0.5.1 (Base) from Passport Advantage:
    IBM WebSphere Application Server V9.0.5.1 Multiplatform Multilingual - Part Number: CC3NXML - File name: was.repo.90501.base.zip 
  2. Download the following from Fix Central:
    1. IBM Installation Manager latest release from "Installation Manager and Packaging Utility download documents"
      From "Download Tables" click "Download Document" for the latest release under "Installation Manager" column. 
      From the resulting page, scroll down to find the Fix Central links for different platforms.
      For example, here are the files for Installation Manager 1.9.2.1 release:
      AIX: agent.installer.aix.gtk.ppc_1.9.2001.20211222_1411.zip
      Linux x86_64: agent.installer.linux.gtk.x86_64_1.9.2001.20211222_1411.zip
      Linux s390x (z Systems): agent.installer.linux.gtk.s390x_1.9.2001.20211222_1411.zip
      Windows x64: agent.installer.win32.win32.x86_64_1.9.2001.20211222_1411.zip
    2. IBM SDK Java Technology Edition latest level from "IBM SDK Java Technology Edition Version 8.0 for WebSphere Application Server V9 and WebSphere Liberty using Installation Manager"
      For example, here are the files for version 8.0.7.0:
      AIX: 8.0.7.0-JavaSE-SDK-aix-ppc64-repo - ibm-java-sdk-8.0-7.0-aix-ppc64-installmgr.zip
      Linux x86_64: 8.0.7.0-JavaSE-SDK-linux-x64-repo - ibm-java-sdk-8.0-7.0-linux-x64-installmgr.zip
      Linux s390x (z Systems): 8.0.7.0-JavaSE-SDK-linux-s390x-repo - ibm-java-sdk-8.0-7.0-linux-s390x-installmgr.zip
      Windows x64: 8.0.7.0-JavaSE-SDK-win-x64-repo - ibm-java-sdk-8.0-7.0-win-x64-installmgr.zip
    3. WebSphere Application Server Version 9.0 latest recommended fix pack from "Recommended updates for WebSphere Application Server"
      Goto the latest download document for latest fix pack. Find the table with heading "WebSphere Application Server traditional" and follow the link from row with "WebSphere traditional (Base..." to the Fix Central and download the file.
      For example, here is the file for version 9.0.5.10: 9.0.5-WS-WAS-FP010.zip
  3. Transfer the files to the system that's going to run WebSphere Application Server 9.0.5.*.
  4. Extract the files:
    1. Installation Manager:
      • AIX:
        mkdir iim1921
        cd iim1921
        unzip -q <path>/agent.installer.aix.gtk.ppc_1.9.2001.20211222_1411.zip
        find . -type f -exec chmod u+x {} \;
      • Linux x86_64:
        mkdir iim1921
        cd iim1921
        unzip -q <path>/agent.installer.linux.gtk.x86_64_1.9.2001.20211222_1411.zip
        find . -type f -exec chmod u+x {} \;
      • Linux s390x:
        mkdir iim1921
        cd iim1921
        unzip -q <path>/agent.installer.linux.gtk.s390x_1.9.2001.20211222_1411.zip
        find . -type f -exec chmod u+x {} \;
      • Windows:
        Using a power shell, cd into a path where you want to extract Installation Manager .zip file.
        Expand-Archive <path>\agent.installer.win32.win32.x86_64_1.9.2001.20211222_1411.zip iim1921
    2. IBM SDK Java Technology Edition
      • AIX:
        mkdir ibm-java-sdk-8.0-7.0
        cd ibm-java-sdk-8.0-7.0
        unzip -q <path>/ibm-java-sdk-8.0-7.0-aix-ppc64-installmgr.zip
      • Linux x86_64:
        mkdir ibm-java-sdk-8.0-7.0
        cd ibm-java-sdk-8.0-7.0
        unzip -q <path>/ibm-java-sdk-8.0-7.0-linux-x64-installmgr.zip
      • Linux s390x:
        mkdir ibm-java-sdk-8.0-7.0
        cd ibm-java-sdk-8.0-7.0
        unzip -q <path>/ibm-java-sdk-8.0-7.0-linux-s390x-installmgr.zip
      • Windows:
        Using a power shell, cd into a path where you want to extract Installation Manager .zip file.
        Expand-Archive .\ibm-java-sdk-8.0-7.0-win-x64-installmgr.zip  ibm-java-sdk-8.0-7.0
    3. WebSphere Application Server Base 9.0.5.1:
      • AIX, Linux:
        mkdir was905.0
        cd was905.0
        unzip -q <path>/was.repo.90501.base.zip
      • Windows:
        Using a power shell, cd into a path where you want to extract Installation Manager .zip file.
        Expand-Archive <path>\was.repo.90501.base.zip was905.0
    4. WebSphere Application Server 9.0.5 Fix Pack 10:
      • AIX, Linux:
        mkdir was905.10
        cd was905.10
        unzip -q <path>/9.0.5-WS-WAS-FP010.zip
      • Windows:
        Using a power shell, cd into a path where you want to extract Installation Manager .zip file.
        Expand-Archive <path>\9.0.5-WS-WAS-FP010.zip was905.10
  5. Install new or update existing Installation Manager in default location - Refer: Installing or updating Installation Manager silently by using the installer
    1. AIX and Linux:
      • Install by using:
        cd <path>/iim1921
        ./installc -log iim1921_install.log -acceptLicense
      • Installation Manager gets installed into /opt/IBM/InstallationManager/ folder.
      • Verify by using:
        /opt/IBM/InstallationManager/eclipse/tools/imcl -version
    2. Windows:
      • Install by using the following commands from a command prompt:
        cd <path>\iim1921
        installc.exe -log iim1921_install.log -acceptLicense
      • By default, Installation Manager gets installed into "C:\Program Files\IBM\Installation Manager\" folder.
      • Verify by using:
        reg query "hklm\software\ibm\Installation Manager"
        "C:\Program Files\IBM\Installation Manager\eclipse\tools\imcl.exe" -version
  6. Install WebSphere Application Server with latest fix pack including IBM SDK Java Technology Edition: 
    1. AIX and Linux:
      • Verify the available packages by using:
        /opt/IBM/InstallationManager/eclipse/tools/imcl listAvailablePackages -repositories <path>/ibm-java-sdk-8.0-7.0,<path>/was905.10,<path>/was905.0
        The repository folders were provided with comma separation.
      • Install by using:
        /opt/IBM/InstallationManager/eclipse/tools/imcl install com.ibm.java.jdk.v8_8.0.7000.20211025_1430 com.ibm.websphere.BASE.v90_9.0.5010.20211108_1200 -repositories <path>/ibm-java-sdk-8.0-7.0,<path>/was905.10,<path>/was905.0 -installationDirectory /opt/IBM/WebSphere/AppServer -sharedResourcesDirectory /opt/IBM/IMShared -acceptLicense
      • Expected output:
        Installed com.ibm.websphere.BASE.v90_9.0.5010.20211108_1200 to the /opt/IBM/WebSphere/AppServer directory.
        Installed com.ibm.java.jdk.v8_8.0.7000.20211025_1430 to the /opt/IBM/WebSphere/AppServer directory.
      • Verify by using:
        /opt/IBM/InstallationManager/eclipse/tools/imcl listInstalledPackages
        /opt/IBM/WebSphere/AppServer/bin/versionInfo.sh
    2. Windows:
      • Verify the available packages by using:
        "C:\Program Files\IBM\Installation Manager\eclipse\tools\imcl.exe" listAvailablePackages -repositories <path>\ibm-java-sdk-8.0-7.0,<path>\was905.10,<path>\was905.0
        The repository folders were provided with comma separation.
      • Install by using:
        "C:\Program Files\IBM\Installation Manager\eclipse\tools\imcl.exe" install com.ibm.java.jdk.v8_8.0.7000.20211025_1430 com.ibm.websphere.BASE.v90_9.0.5010.20211108_1200 -repositories <path>\ibm-java-sdk-8.0-7.0,<path>\was905.10,<path>\was905.0 -installationDirectory "C:\Program Files\IBM\WebSphere\AppServer" -sharedResourcesDirectory "C:\Program Files\IBM\IBMIMShared" -acceptLicense
      • Expected output:
        Installed com.ibm.websphere.BASE.v90_9.0.5010.20211108_1200 to the C:\Program Files\IBM\WebSphere\AppServer directory.
        Installed com.ibm.java.jdk.v8_8.0.7000.20211025_1430 to the C:\Program Files\IBM\WebSphere\AppServer directory.
      • Verify by using:
        "c:\Program Files\IBM\Installation Manager\eclipse\tools\imcl.exe" listInstalledPackages
        "C:\Program Files\IBM\WebSphere\AppServer\bin\versionInfo.bat"
  7. Create a new "Application Server" profile and deploy the IDSWebApp.war file
    1. Use deploy_IDSWebApp script or batch file provided by Directory Server V6.4.0.25 or later fix packs:
      • Requires WebSphere Application Server and SDS V6.4 are installed on the same system.
      • Also, the "Web Administration Tool" package/rpm/feature is already installed. 
      • Go into the <sds64_install_location>/idstools
        Where <sds64_install_location> is as follows:
        AIX: /opt/IBM/ldap/V6.4
        Linux: /opt/ibm/ldap/V6.4
        Windows default installation location: C:\Program Files\IBM\ldap\V6.4
      • Run the deploy_IDSWebApp script or batch file:
        AIX, Linux:
        ./deploy_IDSWebApp -p /opt/IBM/WebSphere/AppServer
        Windows:
        .\deploy_IDSWebApp.bat -p "C:\Program Files\IBM\WebSphere\AppServer"
      • The deploy_IDSWebApp script or batch file, creates a profile named TDSWebAdminProfile and deploys IDSWebApp.war into the profile. The profile server is also started.
      • Connect by using a web browser to URL such as: https://<hostname>:12101/IDSWebApp
    2. Manually create the "Application Server" profile and deploy the IDSWebApp.war file.
      • Create a profile:
        AIX and Linux:
        /opt/IBM/WebSphere/AppServer/bin/manageprofiles.sh -create -profileName AppSrv01 -nodeName DefaultNode -hostName <hostname> -adminUserName wasadmin -adminPassword secret -cellName <hostname>Node01Cell -enableAdminSecurity true -serverName server1 -profilePath /opt/IBM/WebSphere/AppServer/profiles/AppSrv01 -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/default -applyPerfTuningSetting standard -enableService false
        Windows:
        "C:\Program Files\IBM\WebSphere\AppServe\bin\manageprofiles.bat" -create -profileName AppSrv01 -nodeName DefaultNode -hostName <hostname> -adminUserName wasadmin -adminPassword secret -cellName <hostname>Node01Cell -profilePath "C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01" -templatePath "C:\Program Files\IBM\WebSphere\AppServer\profileTemplates\default"
      • Verify the ports from AboutThisProfile.txt from <profilePath>/logs/ folder and note down the important ports:
        Administrative console secure port: 9043
        HTTPS transport port: 9443
      • Start the profile
        AIX and Linux:
        cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
        ./startServer.sh server1

        Windows:
        cd "C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin"
        .\startServer.bat server1
      • Connect to the WebSphere Application Server Admin Console by using URL such as https://<hostname>:9043/ibm/console
      • On the left navigational pane, click Application > New Application.
      • In the New Application page, click New Enterprise Application.
      • In the Path to the new application page, 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.
      • In the How do you want to install the application page, select the Fast Path option and click Next.
      • In the Select installation options page, the default options are selected.
      • Click Next.
      • In the Map modules to server page, you can map modules to the servers that are specified in the Clusters and servers field.
        • Select the check box for the required module, and click Apply.
        • After you complete the mapping, click Next.
      • In the Map virtual hosts for Web modules page, you can map the web application to the specific virtual servers.
        • If there are more virtual hosts, 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.
      • Click Next.
      • In the Map context roots for Web modules page, enter the context root as /IDSWebApp in the field.
      • A summary with your selection is shown.
      • Click Finish.
        It initiates the installation of your application. A summary of installation is shown.
      • To save the changes to the configuration, click Save.
      • On the left navigational pane, click Applications > Application Types > WebSphere enterprise applications.
      • In the Enterprise Applications page, select the check box next to IDSWebApp_war, and click Start to start Web Administration Tool.
      • To access Web Administration Tool, open a browser and enter the following address:
        https://<hostname>:9443/IDSWebApp
Next Step:
To manage directory server instances remotely, open Web Administration Tool and configure directory server instance for remote management. Refer: Accessing Web Administration Tool

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB24","label":"Security Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSVJJU","label":"IBM Security Directory Server"},"ARM Category":[{"code":"a8m0z0000001hpzAAA","label":"Install"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.4"}]

Document Information

Modified date:
01 March 2022

UID

ibm16551822