The web server plugin is an XML file that has markup used to handle the communication between the web server and 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. Then, you customize the plugin.
You can install the IHS web server plugin using the GUI or the command line.
- Command Line - from IBM HTTP repository
- Command Line - from local repository
- Command Line - Response file
From IBM HTTP repository
When installing the plugin via the command line, IBM recommends installing the plugin from the IBM HTTP repository instead of from a local repository, as this ensures that the latest installation files are used during the install.
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 http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90 -prompt com.ibm.websphere.PLG.v90_18.104.22.16860526_1854 com.ibm.websphere.PLG.v90_22.214.171.12460906_0049 com.ibm.websphere.PLG.v90_126.96.36.19961108_1719 . . .
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 com.ibm.websphere.PLG.v80_188.8.131.5260526_1317 -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v80 -installationDirectory /opt/IBM/WebSphere/Plugins -sharedResourcesDirectory /opt/IBM/IMShared -acceptLicense -showProgress -prompt or -masterPasswordFile /var/ibm/InstallationManager/master_password.txt
If installing version 9, you will need to install both the plugin and Java JDK.
~]# ./imcl install com.ibm.websphere.PLG.v90_184.108.40.20671205_1311 com.ibm.java.jdk.v8_8.0.5007.20171218_1035 -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90 -installationDirectory /opt/IBM/WebSphere/Plugins -sharedResourcesDirectory /opt/IBM/IMShared -acceptLicense -showProgress -prompt or -masterPasswordFile /var/ibm/InstallationManager/master_password.txt
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 com.ibm.websphere.PLG.v90_220.127.116.1171205_1311 com.ibm.java.jdk.v8_8.0.5007.20171218_1035 -repositories /tmp/plugin,/tmp/java -installationDirectory /opt/IBM/WebSphere/Plugins -sharedResourcesDirectory /opt/IBM/IMShared -acceptLicense -showProgress -prompt or -masterPasswordFile /var/ibm/InstallationManager/master_password.txt
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"?> <agent-input> <variables> <variable name='sharedLocation' value='/opt/IBM/IMShared'/> </variables> <server> <repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90" /> </server> <profile id='IBM HTTP Plugin V9.0' installLocation='/opt/IBM/WebSpere/Plugins'> <data key='user.import.profile' value='false'/> <data key='cic.selector.nl' value='en'/> </profile> <install modify='false'> <offering id='com.ibm.websphere.PLG.v90' profile='IBM HTTP Plugin V9.0' features='core.feature,ejbdeploy,thinclient,embeddablecontainer' installFixes='none'/> <offering id='com.ibm.java.jdk.v8' profile='IBM HTTP Plugin V9.0' features='com.ibm.sdk.8'/> </install> </agent-input>
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 -showProgress
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 com.ibm.websphere.PLG.v90_18.104.22.16871205_1311 com.ibm.java.jdk.v8_8.0.5007.20171218_1035
The versionInfo.sh utility can be used to verify that the plugin was successfully installed. The plugin-cfg.xml file is the plugin configuration file, and this file is located at plugin_installation_directory/config/server_name/plugin-cfg.xml.
~]# /opt/IBM/WebSphere/Plugin/bin/versionInfo.sh . . . Installed Product -------------------------------------------------------------------------- Name Web Server Plug-ins for IBM WebSphere Application Server Version 22.214.171.124 ID PLG . . .