This tutorial covers how to install an configure Web Server Plug-in for WebSphere Application Server 8.5. The web server will be IBM HTTP Server 8.5. The Web Server Plug-in is a piece of code that bridges the IBM HTTP Server with the WebSphere Application Server.

As per the IBM’s documents of supported Linux distributions, Ubuntu is not supported for IBM products. For evaluation purpose you can install it on Ubuntu, but it is not recommended for production environment. Also you can see it as a reference document to install on another supported Linux distributions.

Following is the summary of what we are going to do in this tutorial

  1. Prerequisites before Install and Configure Web Server Plug-in for WebSphere.
  2. Install Web Server Plug-ins for WebSphere Application Server.
  3. Install WebSphere Customization Toolbox.
  4. Configure Web Server Plug-ins for WebSphere Application Server.
  5. Understand directory structure.
  6. Log files.

Detailed steps of how to install and configure Web Server Plug-ins for WebSphere Application Server are as follows:

  1. Prerequisites before Install and Configure Web Server Plug-in for WebSphere.
    You must install IBM Installation Manager, WebSphere Application Server and IBM HTTP Server on your box.
    We will be using Ubuntu 15.04 64 bit Operating System and WebSphere Application Server 8.5 Network deployment for this setup. Before moving ahead you must have setup your system as per the below guide

    1. Install IBM Installation Manager on Ubuntu
    2. Install WebSphere Application Server on Ubuntu
    3. Create Application Server profile on Ubuntu
    4. Install IBM HTTP Server on Ubuntu
  2. Install Web Server Plug-ins for WebSphere Application Server.
    As we have downloaded all the products in Install IBM HTTP Server topic, we are directly starting with the installation process.

    1. Open a terminal window by pressing Ctrl + ALT + t on your keyboard and navigate to the installation location of IBM Installation manager. In our case installation location is /app/IBM/InstallationManager/eclipse

      cd /app/IBM/InstallationManager/eclipse

      Install and Configure Web Server Plug-in for WebSphere

    2. Enter ./IBMIM to start IBM Installation Manager.
      ./IBMIM

      Install and Configure Web Server Plug-in for WebSphere

    3. Installation Manager opens to the main page.
      Install and Configure Web Server Plug-in for WebSphere
    4. The Install Packages wizard takes you through the installation process for one or more packages. To locate the packages, you must configure the repository.
      Click File > Preferences.
      Install and Configure Web Server Plug-in for WebSphere
    5. Select Repositories and click Add repository
      Install and Configure Web Server Plug-in for WebSphere
    6. Browse to /home/wasadmin/Downloads/supplements/repository.config and click Open.
      Install and Configure Web Server Plug-in for WebSphere
    7. Click on OK button to close the Preferences window.
      Install and Configure Web Server Plug-in for WebSphere
    8. Click the Install icon from the Installation Manager.
      Install and Configure Web Server Plug-in for WebSphere
    9. From the list of installation packages, select only Web Server Plug-ins for IBM WebSphere Application Server, which also selects Version 8.5.0.0. and Click Next
      Install and Configure Web Server Plug-in for WebSphere
    10. As Ubuntu is not certified OS to install Web Server plug-in you may see the following warning. Click Next to proceed further
      Install and Configure Web Server Plug-in for WebSphere
    11. The Licenses panel opens. You can read the license agreements for any of the packages. Select I accept the terms in the license agreement and click Next.
      Install and Configure Web Server Plug-in for WebSphere
    12. In the Installation Directory field, enter an appropriate location to install the IBM Web Server Plug-ins software and click Next button. It does not have to be the same location as the shared location. In our case Installation Directory is /app/IBM/WebSphere/Plugins
      Install and Configure Web Server Plug-in for WebSphere
    13. On the next panel, accept the default selection Web Server Plug-ins for IBM WebSphere Application Server 8.5 as the feature to install. Click Install
      Install and Configure Web Server Plug-in for WebSphere
    14. In case of successful installation you will see following screen. Click Finish
      Install and Configure Web Server Plug-in for WebSphere
  3. Install WebSphere Customization Toolbox.
    The WebSphere Customization Toolbox (WCT) for WebSphere Application Server includes tools for managing, configuring, and migrating various parts of your WebSphere Application Server environment.

    1. From the main page of Installation Manager, click Install.
      Install and Configure Web Server Plug-in for WebSphere
    2. From the list of installation packages, select WebSphere Customization
      Toolbox. This action also selects Version 8.5.0.0.
      Install and Configure Web Server Plug-in for WebSphere
    3. As Ubuntu is not certified OS to install WebSphere Customization Toolbox you may see the following warning. Click Next to proceed further.
      Install and Configure Web Server Plug-in for WebSphere
    4. The Licenses panel opens. You can read the license agreements for any of the packages. Select I accept the terms in the license agreement and click Next.
      Install and Configure Web Server Plug-in for WebSphere
    5. In the Installation Directory field, enter an appropriate location to install the WebSphere Customization tool box and click Next button. In our case Installation Directory is /app/IBM/WebSphere/Toolbox
      Install and Configure Web Server Plug-in for WebSphere
    6. On the Feature panel, select Web Server Plug-ins Configuration Tool. Clear any other check boxes and click Next.
      Install and Configure Web Server Plug-in for WebSphere
    7. On the Summary panel, verify that the only package that is listed under the
      WebSphere Customization Toolbox 8.5 is the Web Server Plug-ins
      Configuration Tool and Click Install
      Install and Configure Web Server Plug-in for WebSphere
    8. When the installation of the packages is complete, select None under Which program do you want to start? Click Finish and Close IBM Installation Manager
      Install and Configure Web Server Plug-in for WebSphere
  4. Configure Web Server Plug-ins for WebSphere Application Server.
    In this part the Web Server Plug-ins Configuration Tool (PCT) is used to configure the web server plug-in.
    Web Server plug-ins works with a web server to route requests for dynamic content, such as servlets, from web applications. The web servers are necessary for directing traffic from browsers to the applications that run on an application server. The web server plug-in uses the XML configuration file to determine whether a request is for an application server.

    1. To start the WebSphere Customization Toolbox, open a terminal by pressing CTRL + ALT + t and navigate to the  WebSphere Customization Toolbox installation directory:
      cd /app/IBM/WebSphere/Toolbox/WCT

      Install and Configure Web Server Plug-in for WebSphere

    2. Enter the following command to star the WebSphere Customization Toolbox
      ./wct.sh

      Install and Configure Web Server Plug-in for WebSphere

    3. Select Web Server Plug-ins Configuration Tool and click Launch Selected Tool.
      Install and Configure Web Server Plug-in for WebSphere
    4. The WebSphere Customization Toolbox opens and looks like the following screen capture
      Install and Configure Web Server Plug-in for WebSphere
    5. In the Web Server Plug-in Runtime Location panel, click ADD
      Install and Configure Web Server Plug-in for WebSphere
    6. In the Add Web Server Plug-in Location panel, enter the following values and click Finish:
      In the Name field, enter : webserver1
      In the Location field, Browse to : /app/IBM/WebSphere/Plugins
      Install and Configure Web Server Plug-in for WebSphere
    7. The web server plug-in runtime is added to the location list.
      Install and Configure Web Server Plug-in for WebSphere
    8. In the Web Server Plug-in Configuration panel, click Create
      Install and Configure Web Server Plug-in for WebSphere
    9. Verify that IBM HTTP Server V8.5 is selected and click Next.
      Install and Configure Web Server Plug-in for WebSphere
    10. Select the 64 bit OS option and click Next. If you are not sure about your Operating System Bit, follow How to Find Operating System Bit in Ubuntu tutorial.
      Install and Configure Web Server Plug-in for WebSphere
    11. In the Web Server Configuration File Selection panel, enter following values and click Next.
      Select the existing IBM HTTP Server httpd.conf file : /app/IBM/HTTPServer/conf/httpd.conf
      Specify the Web server port: 8080
      Install and Configure Web Server Plug-in for WebSphere
    12. In the Setup IBM HTTP Server Administration Server panel, enter the following values (note: expand the dialog box to see all the fields) and click Next:
      Verify that the Setup IBM HTTP Server Administration Server check box is selected.
      HTTP Administration Port: 8008
      Verify that the Create a user ID for IBM HTTP Administration Server authentication check box is selected.
      User ID: ihsadmin
      Password: ihsadmin
      Confirm Password: ihsadmin
      Install and Configure Web Server Plug-in for WebSphere
    13. On the Setup IBM HTTP Server Administration Server panel, enter wasadmin in the
      User ID and Group fields and click Next. We are using wasadmin as the whole setup is on single machine and we have already created wasadmin user to run WebSphere related products.
      Install and Configure Web Server Plug-in for WebSphere
    14. In the Web Server Definition Name panel, verify that the unique name for the web server is webserver1 and click Next.
      Install and Configure Web Server Plug-in for WebSphere
    15. On the configuration Scenario Selection panel, select the Local option and enter the WebSphere installation path as /app/IBM/WebSphere/AppServer
      Click NextInstall and Configure Web Server Plug-in for WebSphereReason behind selection local as we have everything on a single box. Everything means Application Server as well as Web Server. In case if you have Application on different box and Web Server on different box select remote and just enter the host name of the machine where Application Server is install. In case of remote also ensure that you are able to ping remote Application Server from the Web Server.
    16. In the Available Profiles, select AppSrv01 and click Next.
      Install and Configure Web Server Plug-in for WebSphere
    17. On the Plug-in Configuration Summary panel, review your settings. Click Configure
      Install and Configure Web Server Plug-in for WebSphere
    18. When the configuration is complete, the Plug-in Configuration Result panel displays the results. Click Finish
      Install and Configure Web Server Plug-in for WebSphere
    19. The configuration looks like the following screen capture
      Install and Configure Web Server Plug-in for WebSphere
    20. We need to ensure that plug-in file entries are there in the httpd.conf file, hence go to /app/IBM/HTTPServer/conf directory and open httpd.conf file.
      At the end of the file you will see following two entries

      LoadModule was_ap22_module /app/IBM/WebSphere/Plugins/bin/64bits/mod_was_ap22_http.so
      WebSpherePluginConfig /app/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml

      Install and Configure Web Server Plug-in for WebSphere

    21. Login as a wasadmin user and start the Application Server which we have created in How to Create StandAlone Application Server tutorial using following command
      cd /app/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
      ./startServer.sh server1
    22. Try to access the Snoop servlet using following URL
      http://techienote:9080/snoop
      In above 9080 is the HTTP Transport port.
    23. Start the HTTP Server using following commands
      cd /app/IBM/HTTPServer/bin
      ./apachectl start
    24. Point your browser to http://techienote:8080/snoop to test the web server plug-in.
      In our case you will get 404 error as we are using port 8080 for our HTTP Server. We need to add 8080 port into the Virtual Host configuration of WebSphere Application Server. To do the same

      1. Open the administrative console.
        In the administrative console, click Environment > Virtual hosts.
        Install and Configure Web Server Plug-in for WebSphere
      2. Click default_host
        Install and Configure Web Server Plug-in for WebSphere
      3. Under Additional Properties, click Host Aliases.
        Install and Configure Web Server Plug-in for WebSphere
      4. As 8080 host is not there, click New to create a host alias.
        Install and Configure Web Server Plug-in for WebSphere
      5. Enter * in the Host Name field and enter the HTTP Port of 8080 and click on Apply button
        Install and Configure Web Server Plug-in for WebSphere
      6. Click on Review
        Install and Configure Web Server Plug-in for WebSphere
      7. Click on Save button to save the changes
        Install and Configure Web Server Plug-in for WebSphere
      8. Once done you will see port 8080 in Port list
        Install and Configure Web Server Plug-in for WebSphere
    25. To reflect this changes in Plug-in we need to manually generate and propagate the plug-in. To do the same:
      1. Log in to the WebSphere Application Server Administration Console for your profile.
      2. Select Server Types > Web Servers.
        Install and Configure Web Server Plug-in for WebSphere
      3. Check the box next to the web server definition and click the Generate Plug-in button.
        Install and Configure Web Server Plug-in for WebSphere Install and Configure Web Server Plug-in for WebSphere
      4. Check the box next to the web server definition and click the Propagate Plug-in button.
        Install and Configure Web Server Plug-in for WebSphere
        Install and Configure Web Server Plug-in for WebSphere
      5. Restart Application Server as well as Web Server.
    26. Again point your browser to http://techienote:8080/snoop to test the web server plug-in and this time you will get the snoop page without any issue.
      Install and Configure Web Server Plug-in for WebSphere
  5. Understand directory structure of Plug-in
    Under /app/IBM/WebSphere/Plugins directory you will see many folders. Use of those folders are as follows.
    bin: This one is used for programs, scripts, and DLLs
    config: This one is used for configuration directory for plug-in configuration file for your web server
    logs: This one is used for config and web server files
  6. Log files.
    Plugin installation creates a log file named as installIHSPlugin.log under /app/IBM/WebSphere/Plugins/logs/config directory. Check this file for installation errors.If you are unable to access the Snoop servlet from IBM HTTP Server check the following log files for more information
    /app/IBM/HTTPServer/logs/access_log
    /app/IBM/HTTPServer/logs/error_log
    /app/IBM/WebSphere/Plugins/logs/webserver1/http_plugin.log

Hope you have liked this tutorial. Do comment and let me know in case of any issues or error.

If you find any missing point in here, please let us know in comment section or tweet us at @techienotecom. To get more articles like this, subscribe to our RSS feeds.

Install and Configure Web Server Plug-in for WebSphere
Tagged on:         

Leave a Reply

Your email address will not be published. Required fields are marked *

Notify me of followup comments via e-mail. You can also subscribe without commenting.

Recommend on Google