FreeKB - How to install WebSphere IHS web server plugin on Linux on the command line
How to install WebSphere IHS web server plugin on Linux on the command line

Home > Search > How-to

The web server plugin is used to facilitate communication between a web server and a WebSphere application server.  You would install the plugin after you have already installed and configured IBMs IHS web server and a WebSphere application server.


If you have not installed IBM Installation Manager, install IBM Installation Manager. Setting up the plugin is a two part process. First, you install the plugin on the web server. Then, you customize the plugin.


From IBM HTTP repository

List the available packages. The -prompt option is used to get a prompt to provide your IBM username and password.

~]# cd /opt/IBM/InstallationManager/eclipse/tools/
~]# ./imcl listAvailablePackages -repositories -prompt
. . .


Install the plugin. If installating version 8 of the plugin, there is no need to also install Java SDK separately, as Java JDK is included in version 8. Your IBM username and password will be stored in a secure storage file, which is usually located at /var/ibm/InstallationManager/secure_storage. If you have not yet created the secure storage file, you can use the -prompt option to create the secure storage file. Or, you can manually create the secure storage file. The secure storage file will be protected by a master password. If you use the -prompt option, you will need to type in the master password. Or, you can created the master_password.txt file and store the master password in the master_password.txt.

~]# ./imcl install \
  -repositories \ 
  -installationDirectory /opt/IBM/WebSphere/Plugins \
  -sharedResourcesDirectory /opt/IBM/IMShared \
  -acceptLicense \
  -showVerboseProgress \


If installing version 9, you will need to install both the plugin and Java JDK.

~]# ./imcl install \ \ \
  -repositories  \
  -installationDirectory /opt/IBM/WebSphere/Plugins \
  -sharedResourcesDirectory /opt/IBM/IMShared \
  -acceptLicense \
  -showVerboseProgress \


From local repository

Installing offering from a local repository is nearly identical to installing from IBM HTTP repository, except you would download the products you want to install from Fix Central. If installing version 9 of the plugin, don't forget to download Java JDK. After the packages have been downloaded, you will unzip the packages to a location on your server, such as /tmp/plugin and /tmp/java. Then, you can use /tmp/plugin and /tmp/java in the install command.

~]# ./imcl install \ \ \
  -repositories /tmp/plugin,/tmp/java  \
  -installationDirectory /opt/IBM/WebSphere/Plugins \
  -sharedResourcesDirectory /opt/IBM/IMShared \
  -acceptLicense \
  -showVerboseProgress \


Response file

A request file is an XML file that contains details regarding the product being installed, such as the offering ID and the installation directory. Create the response file.

~]# touch /opt/IBM/response_file.xml


Add the following text to the response_file.xml. In this example, version 9 of the plugin is installed, along with Java JDK.

<?xml version="1.0" encoding="UTF-8"?>
    <variable name='sharedLocation' value='/opt/IBM/IMShared'/>

    <repository location="" />

  <profile id='IBM HTTP Plugin V9.0' installLocation='/opt/IBM/WebSpere/Plugins'>
    <data key='user.import.profile' value='false'/>
    <data key='' value='en'/>

  <install modify='false'>
    <offering id='' 
      profile='IBM HTTP Plugin V9.0' 
      features='core.feature,ejbdeploy,thinclient,embeddablecontainer' installFixes='none'/>
    <offering id=''
      profile='IBM HTTP Plugin V9.0'


You can create a response file by issuing the following command, which will launch the Installation Manager GUI, so this must be done in a graphical environment. Follow the steps on installing WebSphere using the GUI.

~]# cd /opt/IBM/InstallationManager/eclipse
~]# ./IBMIM -record /path/to/response.xml -skipInstall /opt/IBM


Install the plugin.

./imcl input /opt/IBM/response_file.xml \
  -secureStorageFile /var/ibm/InstallationManager/secure_storage \
  -masterPasswordFile /var/ibm/InstallationManager/master_password.txt \
  -acceptLicense \


Post installation

The plugin_installation_directory/logs/install/log.txt file can be reviewed to ensure the installation was successful.

The listInstalledPackages command can be used to see what packages are installed.. In this example, the plugin and Java JDK are installed.

~]# ./imcl listInstalledPackages


The utility can be used to verify that the plugin was successfully installed.

~]# /opt/IBM/WebSphere/Plugin/bin/
. . .
Installed Product
Name              Web Server Plug-ins for IBM WebSphere Application Server 
ID                PLG
. . .


Add a Comment

We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.

Please enter in the box below so that we can be sure you are a human.