[AIX HP-UX Linux Solaris Windows]

Installing Web server plug-ins

WebSphere Application Server products supply a unique binary plug-in module for each supported Web server. The plug-in configuration file, which the WebSphere Application Server products create and maintain, interacts with the binary module to provide information about the application server configuration to the Web server. The Web server uses the information to determine how to communicate with the application server, but to locate specific applications on the application server.

Before you begin

See Web server plug-in policy for WebSphere® Application Server for information about how to verify what Version 4.0, Version 5.0, Version 5.1, Version 6.0, Version 6.1, and Version 7.0 plug-in versions are installed on local or remote Web servers, and how to determine if the installation complies with supported configurations.

You must install a supported Web server before you can install a plug-in for the Web server. You are not required to install the application server to install the plug-in. To create a Web server configuration for unmanaged nodes, however, you must install the application server.

The Plug-ins installation wizard installs the plug-in module, configures the Web server for communicating with the application server, and creates a Web server configuration definition in the application server, if possible.

Some topologies, such as the Web server on one system and the application server on another system, prevent the Plug-ins installation wizard from creating the Web server definition in the application server configuration on the remote system. In such a case, the Plug-ins installation wizard creates a script that you can copy to the application server system. Run the script to create the Web server configuration definition within the application server configuration.

When multiple profiles exist, the plug-ins installer configures only the default profile. See Plug-ins configuration for a description of the flow of logic that determines how the installer selects the profile to configure.

[Windows 2008 Server] Guidelines for installing the Microsoft® Internet Information Server (IIS) plug-in: To install the IIS Web server plug-in for use with WebSphere Application Server Version 7.0, you must complete the following steps. These same steps apply to both IIS V7 and 7.5.
  1. Install IIS 7.x with the necessary IIS 6 Management Compatibility components. IIS 6 compatibility components are not automatically installed by default.
    1. Start the Server Manager panel on Windows Server 2008 by performing the following steps:
      1. Click Start > Administrative Tools > Server Managers
      2. Click Action > Add Roles.
      3. Click Next on the initial panel that displays.
      4. On the Select Server Roles panel, select the Web Server (IIS) role and click Next.
      5. If a prompt for the Windows Process Activation Service feature displays, then click Add Feature > Next.
      6. Click Next on the IIS introduction panel.
    2. When the Role Services panel displays, make sure that the following options are selected in addition to the default options that are already selected:
      • Internet Information Services: Management Tools
      • IIS 6 Management Compatibility: IIS 6 Management Console, IIS 6 Scripting Tools, IIS 6 WMI Compatibility, and IIS Metabase compatibility
      • Application Development: ISAPI Extensions, ISAPI Filters
    3. Click Next to enable the selected options.
    4. Click Install on the next panel to perform the installation.
    5. Click Close on the Installation Results panel.
  2. Create a new IIS web site instance if the Default Web Site instance no longer exists:
    1. Start the IIS application by clicking Start > All Programs > Administrative Tools > Internet Information Services (IIS) Manager .
    2. Use the Add Web Site dialog to add a new Web site to your Web server. Type the Site name and browse to the Physical Path, click the Test Settings button. If the settings test fails, then either change the permissions of the physical directory or select Connect As.. and have IIS connect as a Windows user account that has authority to files in that physical path. Click OK to save changes.
  3. Install the Web server plug-ins using the Windows installer, which is provided with WebSphere Application Server. Complete the following steps to install the Web server plug-ins:
    1. To start the Web server plug-in installer, right-click the install.exe shortcut in the plugin directory and select Run as Administrator. Alternatively, use the launchpad utility to install the Web server plug-ins when you are logged in as the built-in administrator account.
    2. Accept all of the security dialogs and system prerequisite checking panels that are presented.
    3. Select Microsoft Internet Information Services V7 as the Web server to configure.
    4. If necessary, configure a Web server definition as described in the plug-ins configuration.
    5. Restart IIS 7.x and your WebSphere Application Server profile.
    Restriction: Do not install Web server plug-ins into directories with parentheses () characters in the path name. On Windows Server 2008, for example, the plug-in installation fails if you use the default installation path of C:\Program Files (x86)\IBM\WebSphere\Plugins.
    If you installed the Web server plug-in or IBM HTTP Server into a directory that has parentheses in the path name, complete one of the following actions:
    • Uninstall the product and reinstall it to a directory location that does not have parentheses in the path name.
    • Manually update the following values with the correct path names:
      1. Update the ServerRoot, AuthUserFile, and Keyfile values in the IHS_install_root\conf\admin.conf file.
      2. Update the ServerRoot .AfpaLogFile, DocumentRoot, Directory, Alias/icons/, and ScriptAlias values in IHS_install_root\conf\httpd.conf file.
      3. Update the JAVA_HOME and GSK_HOME values in IHS_install_root\bin\ikeyman.bat file.
      4. Update the shortcut key values with the correct path name. For example, C:\Documents and Settings\All Users\Start Menu\Programs\IBM HTTP Server V6.1.

About this task

This topic describes installing a Web server plug-in for WebSphere Application Server. WebSphere Application Server products supply a unique binary plug-in module for each supported Web server. The plug-in configuration file, which the WebSphere Application Server products create and maintain, interacts with the binary module to provide information about the application server configuration to the Web server. The Web server uses the information to determine how to communicate with the application server, but to locate specific applications on the application server.

The Plug-ins installation wizard installs required files and configures the Web server and the application server to allow communication between the servers.

Select one of the following topology scenarios and follow the steps below the diagram to install the plug-in and configure both the Web server and the application server.

When multiple profiles exist, the plug-ins installer configures only the default profile. See Plug-ins configuration for a description of the flow of logic that determines how the installer selects the profile to configure.

Procedure

Results

You can install a Web server and the Web server plug-ins for various standalone application server topologies by following the procedures described in this topic.

What to do next

See Selecting a Web server topology diagram and roadmap for an overview of the installation procedure.

See Web server configuration for more information about the files involved in configuring a Web server.

See Editing Web server configuration files for information about how the Plug-ins installation wizard configures supported Web servers.




In this information ...


Related information

IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 10:04:34 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-mp&topic=tins_webplugins
File name: tins_webplugins.html