Web Server Plug-ins installation information

About the Web Server Plug-ins

The Web Server Plug-ins for IBM WebSphere Application Server provides an interface between WebSphere Application Server and a web server, such as IBM HTTP Server. The web server plug-in determines the server to which a client request, such as servlets, needs to be routed.

Before you install the Web Server Plug-ins, plan your web server topology and determine where to install each component.

For information about various application server and web server topologies, see Selecting a web server topology diagram and roadmap.

Requirements

In addition to the following requirements, your system might require other prerequisites so that you can install WebSphere Application Server offerings. For more information, see Preparing the operating system for product installation.

Repositories and offering IDs

To install the Web Server Plug-ins from the online service repository, use the following repository URL with Installation Manager:

http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90

When you use the command line or response files to install, uninstall, or otherwise modify the Web Server Plug-ins, specify the following offering ID:

com.ibm.websphere.PLG.v90

For a complete list of product repositories and offering IDs, see Online product repositories for WebSphere Application Server offerings and WebSphere Application Server product offerings for supported operating systems.

Installation examples

All WebSphere Application Server offerings are installed by using IBM Installation Manager.

For step-by-step instructions for installing product offerings, see Installing the product offerings.

Important: Because IBM SDK Java Technology Edition is no longer embedded with the product, you must specify both the Web Server Plug-ins offering ID (com.ibm.websphere.PLG.v90) and the IBM Java SDK offering ID (com.ibm.java.jdk.v8). The Web Server Plug-ins cannot be installed without a Java SDK.

The following installation examples are for the command line:

For step-by-step instructions for installing by using the command line, see Installing the product offerings by using the command line.

• 

  imcl.exe install com.ibm.websphere.PLG.v90 com.ibm.java.jdk.v8
    -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90 
    -installationDirectory "C:\Program Files\IBM\WebSphere\Plugins"
    -sharedResourcesDirectory "C:\Program Files\IBM\IMShared"
    -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false
    -secureStorageFile C:\IM\credential.store -masterPasswordFile C:\IM\master_password.txt
    -log installv9plugins.xml
    -acceptLicense
    -showProgress

• 

  ./imcl install com.ibm.websphere.PLG.v90 com.ibm.java.jdk.v8
    -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90 
    -installationDirectory /opt/IBM/WebSphere/Plugins
    -sharedResourcesDirectory /opt/IBM/IMShared
    -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false
    -secureStorageFile /var/IM/credential.store -masterPasswordFile /var/IM/master_password.txt
    -log installv9plugins.xml
    -acceptLicense
    -showProgress

• 

  ./imcl install com.ibm.websphere.PLG.v90
    -repositories https://downloads.mycorp.com:8080/WAS_90_repository
    -installationDirectory /QIBM/ProdData/WebSphere/Plugins/V9/webserver
    -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Plugins/V9/webserver
    -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
    -secureStorageFile $HOME/WASFiles/temp/credential.store
    -acceptLicense
    -showProgress

The following installation examples are for the response file. For step-by-step instructions for installing by using a response file, see Installing the product offerings by using response files.

• 

  <?xml version="1.0" encoding="UTF-8"?>
  <agent-input clean="true" temporary="true">
  <server>
  <repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90" /> 
  </server>
  <install modify='false'>
  <offering id='com.ibm.websphere.PLG.v90' 
    profile='Web Server Plug-ins for IBM WebSphere Application Server V9.0' 
    features='core.feature' installFixes='none'/>
  <offering id='com.ibm.java.jdk.v8'
    profile='Web Server Plug-ins for IBM WebSphere Application Server V9.0'
    features='com.ibm.sdk.8'/>
  </install>
  <profile id='Web Server Plug-ins for IBM WebSphere Application Server V9.0' 
    installLocation='C:\Program Files\IBM\WebSphere\Plugins'>
  <data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\Plugins'/>
  <data key='user.import.profile' value='false'/>
  <data key='cic.selector.nl' value='en'/>
  </profile>
  </agent-input>

• 

  <?xml version="1.0" encoding="UTF-8"?>
  <agent-input>
  <server>
    <repository location='http://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v90'/>
  </server>
  <profile id='Web Server Plug-ins for IBM WebSphere Application Server V9.0' installLocation='/QIBM/ProdData/WebSphere/Plugins/V9/webserver'>
    <data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/Plugins/V9/webserver'/>
    <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/Plugins/V9/webserver'/>
    <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='Web Server Plug-ins for IBM WebSphere Application Server V9.0' 
    features='core.feature'/>
  </install>
  <preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='/QIBM/UserData/InstallationManager/IMShared'/>
  <preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
  <preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
  <preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
  <preference name='offering.service.repositories.areUsed' value='true'/>
  <preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
  <preference name='http.ntlm.auth.kind' value='NTLM'/>
  <preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
  <preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
  <preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
  <preference name='PassportAdvantageIsEnabled' value='false'/>
  <preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
  </agent-input>
  

Usage notes

The versionInfo and historyInfo commands return version and history information for the Web Server Plug-ins based on all of the installation, uninstallation, update, and rollback activities performed on the system.

After you install the Web Server Plug-ins, you can create a plug-ins profile using the manageprofiles command. The following is an example of using the manageprofiles command to create a default plug-ins profile.

manageprofiles -create
  -templatePath /QIBM/ProdData/WebSphere/Plugins/V9/webserver/profileTemplates/http
  -profileName PluginsSrv01

Note: After you create a profile successfully, the console prints a message that indicates success and advises you to check the AboutThisProfile.txt file. However, a AboutThisProfile.txt file is not generated when you create a plug-ins profile on IBM i.

Uninstallation examples

All WebSphere Application Server offerings are uninstalled by using IBM Installation Manager.

For step-by-step instructions for uninstalling product offerings, see Uninstalling the product offerings.

Avoid trouble: IBM SDK, Java Technology Edition (com.ibm.java.jdk.v8) must be uninstalled at the same time that you uninstall the product offering.

The following uninstallation examples are for the command line:

For step-by-step instructions for uninstalling by using the command line, see Uninstalling the product offerings by using the command line.

• 

  ./imcl uninstall com.ibm.websphere.PLG.v90 com.ibm.java.jdk.v8
    -installationDirectory /opt/IBM/WebSphere/Plugins

• 

  ./imcl uninstall com.ibm.websphere.PLG.v90
    -installationDirectory /QIBM/ProdData/WebSphere/Plugins/V9/webserver

The following uninstallation examples are for the response file. For step-by-step instructions for uninstalling by using a response file, see Uninstalling the product offerings by using response files

• 

  <?xml version="1.0" encoding="UTF-8"?>
  <agent-input clean='true' temporary='true'>
  <uninstall modify='false'>
  <offering id='com.ibm.websphere.PLG.v90' 
    profile='Web Server Plug-ins for IBM WebSphere Application Server V9.0'/>
  <offering id='com.ibm.java.jdk.v8' 
    profile='Web Server Plug-ins for IBM WebSphere Application Server V9.0' />
  </uninstall>
  <profile id='Web Server Plug-ins for IBM WebSphere Application Server V9.0' 
    installLocation='C:\Program Files\IBM\WebSphere\Plugins'>
  <data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\Plugins'/>
  <data key='user.import.profile' value='false'/>
  <data key='cic.selector.nl' value='en'/>
  </profile>
  </agent-input>

• 

  <?xml version="1.0" encoding="UTF-8"?>
  <agent-input clean='true' temporary='true'>
  <uninstall modify='false'>
  <offering id='com.ibm.websphere.PLG.v90' 
    profile='Web Server Plug-ins for IBM WebSphere Application Server V9.0'/>
  </uninstall>
  <profile id='Web Server Plug-ins for IBM WebSphere Application Server V9.0' 
    installLocation='/QIBM/ProdData/WebSphere/Plugins/V9/webserver'>
    <data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/Plugins/V9/webserver'/>
    <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/Plugins/V9/webserver'/>
    <data key='user.import.profile' value='false'/>
    <data key='cic.selector.nl' value='en'/>
  </profile>
  </profile>
  </agent-input>