Configure Microsoft Internet Information Services (IIS)

The Web Server Plug-ins Configuration Tool configures the web server. This topic describes how to configure the Internet Information Services (IIS) Web Server manually. Other procedures in Edit web server configuration files describe configuring other supported web servers.

We must have read/write access to the plugins_root directory to perform this task.


Configure IIS v6.0

  1. Start the IIS application and create a new virtual directory for the website instance that you intend to work with WebSphere Application Server. These instructions assume that you are using the Default Web Site.

    Click Programs > Administrative Tools > Internet Information Services (IIS) Manager on a Windows Server 2003 Standard Edition system, for example.

  2. Expand the tree until you see Default Web Site.

    Right-click Default Web Site > New > Virtual Directory to create the directory with a default installation.

  3. Type sePlugins in the Alias field in the Virtual Directory Alias panel, then click Next.

  4. Browse to the plugins_root\bin\IIS_web_server_name directory in the Path field of the Web Site Content Directory panel , then click Next.

    For example, select...

      C:\IBM\WebSphere\Plugins\bin\IIS_webserver1

  5. Select the appropriate permission check boxes in the Virtual Directory Access Permissions panel.

    Select the Read check box and the Execute (such as ISAPI applications or CGI) check box, for example.

  6. Click Next to add the sePlugins virtual directory to the default website.

  7. Click Finish when the success message displays.

  8. Copy the plug-in binaries to the plugins_root \bin\IIS_web_server_name directory.

    For example. copy the plug-in binary files to...

      C:\IBM\WebSphere\Plugins\bin\IIS_webserver1

    The plugin-cfg.loc file resides in this directory. The first line of the plugin-cfg.loc file identifies the location of the plugin-cfg.xml file.

  9. Expand the Web Sites folder in the navigation tree of the IIS Manager panel.

  10. Right-click Default Web Site in the navigation tree and click Properties.

  11. Add the Internet Services Application Programming Interface (ISAPI) filter into the IIS configuration.

    In the Default Web Site Properties panel, perform the following steps:

    1. Click the ISAPI Filters tab.

    2. Click Add to open the Add/Edit Filter Properties dialog window.

    3. Type iisWASPlugin in the Filter name field.

    4. Click Browse to select file...

        C:\IBM\WebSphere\Plugins\bin\IIS_webserver1\iisWASPlugin_http.dll

      ..for the value of the Executable field.

      Browse to...

        plugins_root \bin\IIS_web_server_name

      ...to select the iisWASPlugin_http.dll file.

    5. Click OK to close the Add/Edit Filter Properties dialog window.

    6. Click OK to close the Default Web Site Properties window.

  12. Set the value in the plugin-cfg.loc file to the location of the configuration file.

    Set the location to the plugins_root\config\ webserver_name\plugin-cfg.xml file, which might be C:\IBM\WebSphere\Plugins\config\IIS_webserver1\plugin-cfg.xml file.

    The location varies depending on how you have configured the system. If the web server and the application server are on separate machines, you have a remote installation.

    If the two servers are on the same machine, you have a local installation.

    If the two servers are on the same machine and the application server is federated, you have a local distributed installation.

    Local distributed example:

      "C:\IBM\WebSphere\AppServer\profiles\custom01\config\cells\dmgrcell\nodes\managed_node\servers\webserver1\plugin-cfg.xml"

    Local example:

      "C:\IBM\WebSphere\Plugins\config\webserver1\plugin-cfg.xml"

  13. Configure the web server to run WebSphere Application Server extensions:

    1. Expand the navigation tree and click on the Web Service Extensions folder in the IIS Manager panel.

    2. Click Add a new web service extension to open the New Web Service Extension dialog window.

    3. In the Extension name field, type WASPlugin as the name of the new web service extension.

    4. Click Add to open the Add file dialog window.

    5. In the Path to file field, type the path or click Browse to navigate to the correct iisWASPlugin_http.dll file that the new web service extension requires, and click OK.

    6. Select the Set extension status to Allowed check box to automatically set the status of the new web service extension to Allowed and click OK.


Configure IIS v7.x

(Windows2008) Supported configurations: We can use IIS v7 with Windows Server 2008 and IIS v7.5 with Windows Server 2008 R2.

  1. Install IIS v7.x with the necessary IIS v6.0 Management Compatibility components.

    IIS v6.0 Management Compatibility components are not automatically installed by default. Complete the following steps to install IIS v7.x with the necessary IIS v6.0 Management Compatibility components.

    • (Windows2008) Complete the following steps to install IIS v7.x on Windows Server 2008:

      1. Click Start > Administrative Tools > Server Managers.

      2. Click Action > Add Roles, and then click Next.

      3. On the Select Server Roles page, select the Web Server (IIS) role, and then click Next.

      4. If a prompt for the Windows Process Activation Service feature displays, click Add Feature > Next, and then click Next on the IIS introduction page

      5. When the Role Services window displays, verify that the following options are selected in addition to the default options already selected.

          Internet Information Services Management Tools
          IIS v6.0 Management Compatibility IIS v6.0 Management Console, IIS v6.0 Scripting Tools, IIS v6.0 WMI Compatibility, and IIS Metabase compatibility
          Application Development ISAPI Extensions, ISAPI Filters

      6. Click Next to enable the selected options, and then click Install on the next window to perform the installation.

      7. When the installation finishes, click Close on the Installation Results window.

    • Complete the following steps to install IIS v7.x on Windows 7:

      1. Click Start > Control Panel > Programs and Features.

      2. In the Programs and Features window, click Turn Windows features on or off.

      3. In the Windows Features dialog box, expand Internet Information Services and select all of the options under it.

      4. Click OK.

        The progress indicator displays.

        When the installation completes, the Windows Features dialog box closes and the Control Panel is displayed.

      5. To confirm that the installation succeeded, enter the following URL in the browser: http://localhost.

      6. To start and restart the IIS7 web server, click Start > Control Panel > Administrative Tools > Internet Information Service (IIS) Manager > (Restart\Start\Stop).

  2. Install the web server plug-ins.

    For an already installed web server plug-in, go to the next step, and re-configure IIS v7.x to use that web server plug-in.

  3. Optional: Re-configure IIS v7.x if the web server plug-in is already installed:

    The following steps are completed automatically during web server plug-in installation. You only need to complete these steps are if you are re-configuring IIS v7.x to use an existing web server plug-in.

    Complete the following steps to re-configure IIS v7.x:

    1. Click Start > All Programs > Administrative Tools > Internet Information Services (IIS) Manager. This action starts the IIS application, and creates a new virtual directory for the website instance that you intend to use with WebSphere Application Server. These instructions assume that you are using the default website.

    2. Expand the tree until you see Default Web Site.

    3. Right-click Default Web Site > Add Virtual Directory to create the directory with a default installation.

    4. Type sePlugins in the Alias field on the Virtual Directory Alias window.

    5. Browse to the plugins_root\bin\IIS_web_server_name directory in the Physical Path field of the Web Site Content Directory window, and then click OK. For example, select...

        C:\IBM\WebSphere\Plugins\bin\IIS_webserver1

    6. Click the Test Settings button.

      If the settings test fails, then either change the permissions of the physical directory, or select Connect As, and let IIS connect as a Windows user account that has authority to files in that physical path.

      When you click the Test Settings button, you might encounter the following warning message if you use the default "Pass-thru authentication" setting:

        Cannot verify access to path

    7. Click OK to add the sePlugins virtual directory to the default website.

    8. In the navigation tree, select the sePlugins virtual directory that you just created.

    9. On the Features panel, double-click Handler Mappings, and then click Edit Feature Permissions on the Actions panel.

    10. Select Script and Execute, if they are not already selected.

    11. Click OK.

    12. Manually copy the plug-in binaries to...

        plugins_root\bin\IIS_web_server_name

      For example, copy the plug-in binary files to...

        C:\IBM\WebSphere\Plugins\bin\IIS_webserver1

      The plugin-cfg.loc file resides in this directory. The first line of the plugin-cfg.loc file identifies the location of the plugin-cfg.xml file.

    13. Return to the IIS Manager window, and expand the Web Sites folder in the left-hand navigation tree of that window.

    14. Select Default Web Site in the navigation tree.

    15. Add the Internet Services Application Programming Interface (ISAPI) filter into the IIS configuration.

      On the Default Web Site Properties panel...

      1. Double-click the ISAPI Filters tab.

      2. Click to open the Add/Edit Filter Properties dialog window.

      3. Type iisWASPlugin in the Filter name field.

      4. Click Browse to select the plug-in file located in...

          plugins_root\bin\IIS_web_server_name\iisWASPlugin_http.dll

      5. Click OK to close the Add/Edit Filter Properties dialog window.

    16. In the navigation tree, select the top level server node.

    17. On the Features panel, double-click ISAPI and CGI Restrictions, and then, on the Actions panel, click Add.

      To determine the value to specify for the ISAPI or CGI Path property, browse to, and then select the same plug-in file selecteded in the previous step. For example:

        plugins_root\bin\IIS_web_server_name\iisWASPlugin_http.dll

      Then type WASPlugin in the Description field, select Allow extension path to execute, and then click OK to close the ISAPI and CGI Restrictions dialog window.

    18. Set the value in the plugin-cfg.loc file to the location of the configuration file at plugins_root \config\webserver_name\plugin-cfg.xml.

      Following is the default location:

        C:\IBM\WebSphere\Plugins\config\IIS_webserver1\plugin-cfg.xml

      The location varies depending on how you have configured the system. If the web server, and WebSphere Application Server are on separate machines, you have a remote installation. If the web server, and WebSphere Application Server are on the same machine, then you have a local installation, and the correct location of the configuration file might be set. If the two servers are on the same machine, and the application server is federated, you have a local distributed installation.

      Local distributed example:

        C:\IBM\WebSphere\AppServer\profiles\custom01\config\cells\dmgrcell\nodes\managed_node\servers\webserver1\plugin-cfg.xml

      Local example:

        C:\IBM\WebSphere\Plugins\config\webserver1\plugin-cfg.xml

    19. Restart IIS v7.x and the WAS profile.


Configure IIS v8.x

Supported configurations: We can use IIS v8 with Windows Server 2012.

  1. Install IIS v8.x with the necessary IIS v6.0 Management Compatibility components.

    IIS v6.0 Management Compatibility components are not automatically installed by default. Complete the following steps to install IIS v8.x with the necessary IIS v6.0 Management Compatibility components.

    • To install IIS v8.x on Windows Server 2012:

      1. Bring up the Server Manager

      2. Select the installation type based on the environment and then click Next.

      3. Select the server that will receive the installation and then click Next.

      4. When the Server Roles window displays, verify that the following options are selected in addition to the default options already selected.

          Management Tools IIS Management Console
          IIS v6.0 Management Compatibility IIS v6.0 Management Console, IIS v6.0 Scripting Tools, IIS v6.0 WMI Compatibility, and IIS Metabase compatibility
          IIS Management Scripts and Tools
          Application Development ISAPI Extensions, ISAPI Filters

    • Click Next to enable the selected options, and then click Install on the next window to perform the installation.

  2. Install the web server plug-ins.

    For an already installed web server plug-in, go to the next step, and re-configure IIS v8.x to use that web server plug-in.

  3. Optional: Re-configure IIS v8.x if the web server plug-in is already installed:

    The following steps are completed automatically during web server plug-in installation. You only need to complete these steps are if you are re-configuring IIS v8.x to use an existing web server plug-in.

    Complete the following steps to re-configure IIS v8.x:

    1. Click the Tools> Internet Information Services (IIS) Manager within the Server Manager screen. This action starts the IIS application, and creates a new virtual directory for the website instance that you intend to use with WebSphere Application Server. These instructions assume that you are using the default website.

    2. Expand the tree until you see Default Web Site.

    3. Right-click Default Web Site > Add Virtual Directory to create the directory with a default installation.

    4. Type sePlugins in the Alias field on the Virtual Directory Alias window.

    5. Browse to the plugins_root\bin\IIS_web_server_name directory in the Physical Path field of the Web Site Content Directory window, and then click OK. For example, select...

        C:\IBM\WebSphere\Plugins\bin\IIS_webserver1

    6. Click the Test Settings button. If the settings test fails, then either change the permissions of the physical directory, or select Connect As, and let IIS connect as a Windows user account that has authority to files in that physical path.

      When you click the Test Settings button, you might encounter the following warning message if you use the default "Pass-thru authentication" setting:

        Cannot verify access to path

    7. Click OK to add the sePlugins virtual directory to the default website.

    8. In the navigation tree, select the sePlugins virtual directory that you just created.

    9. On the Features panel, double-click Handler Mappings, and then click Edit Feature Permissions on the Actions panel.

    10. Select Script and Execute, if they are not already selected.

    11. Click OK.

    12. Manually copy the plug-in binaries to...

        plugins_root\bin\IIS_web_server_name

      For example, copy the plug-in binary files to...

        C:\IBM\WebSphere\Plugins\bin\IIS_webserver1

      The plugin-cfg.loc file resides in this directory. The first line of the plugin-cfg.loc file identifies the location of the plugin-cfg.xml file.

    13. Return to the IIS Manager window, and expand the Web Sites folder in the left-hand navigation tree of that window.

    14. Select Default Web Site in the navigation tree.

    15. Add the Internet Services Application Programming Interface (ISAPI) filter into the IIS configuration.

      On the Default Web Site Properties panel...

      1. Double-click the ISAPI Filters tab.

      2. Click to open the Add/Edit Filter Properties dialog window.

      3. Type iisWASPlugin in the Filter name field.

      4. Click Browse to select the plug-in file located in...

          plugins_root \bin\IIS_web_server_name\iisWASPlugin_http.dll

      5. Click OK to close the Add/Edit Filter Properties dialog window.

    16. In the navigation tree, select the top level server node.

    17. On the Features panel, double-click ISAPI and CGI Restrictions, and then, on the Actions panel, click Add.

      To determine the value to specify for the ISAPI or CGI Path property, browse to, and then select the same plug-in file selecteded in the previous step. For example:

        plugins_root\bin\IIS_web_server_name\iisWASPlugin_http.dll

      Then type WASPlugin in the Description field, select Allow extension path to execute, and then click OK to close the ISAPI and CGI Restrictions dialog window.

    18. Set the value in the plugin-cfg.loc file to the location of the configuration file at plugins_root\config\webserver_name\plugin-cfg.xml.

      Following is the default location:

        C:\IBM\WebSphere\Plugins\config\IIS_webserver1\plugin-cfg.xml

      The location varies depending on how you have configured the system. If the web server, and WebSphere Application Server are on separate machines, you have a remote installation. If the web server, and WebSphere Application Server are on the same machine, then you have a local installation, and the correct location of the configuration file might be set. If the two servers are on the same machine, and the application server is federated, you have a local distributed installation.

      Local distributed example:

        C:\IBM\WebSphere\AppServer\profiles\custom01\config\cells\dmgrcell\nodes\managed_node\servers\webserver1\plugin-cfg.xml

      Local example:

        C:\IBM\WebSphere\Plugins\config\webserver1\plugin-cfg.xml

    19. Restart IIS v8.x and the WAS profile.


Enable IIS v6.0, v7.x, or v8.0 to communicate with a web server plug-in running in 32-bit mode

The web server plug-in for IIS is available in both 32-bit and 64-bit versions. When using the 32-bit version plug-in on a Microsoft Windows 64-bit operating system, the following steps should be taken to enable the native 64-bit IIS to run the plug-in under a 32-bit worker process.

The Windows Server TechNet topic Run 32-bit Applications on 64-bit Windows describes how to enable the native 64-bit IIS v6.0 to run the web server plug-in under a 32-bit worker process.

Complete the following steps to enable the native 64-bit IIS v7.x to run the web server plug-in under a 32-bit worker process:

  1. Launch the IIS v7.x or IIS v8.0 console.

  2. On the connections page, expand the Sites node, and select the website intended for the web server plug-in.

  3. On the actions page, click Basic Settings, and make a note of the Application Pool name.

  4. Click Cancel , and then select the Application Pools node on the connections page.

  5. On the features page, right-click the application pool that you noted in the earlier step, and then choose Advanced Settings.

  6. Set the Enable 32-bit Applications property to True.

  7. Click OK to complete the configuration change.

  8. Restart the corresponding application pool.

  • Optional: Configure multiple websites. Given:

    • There are two websites defined: website1 and website2.

    • The DLL files are already created as bin/website1/iisWASPlugin_http.dll and bin/website2/iisWebsite2/iisWASPlugin_http.dll.

    • The plugin-cfg.loc files are created in the same folder as the DLL files.

    1. Run IIS in worker process isolation mode (default).

      To enable worker process in isolation mode:

      1. Open the IIS Manager console and expand the local computer by clicking the plus sign.

      2. Expand the Web Sites folder, then right-click the Default Web Sites folder.

      3. Click Properties, then click the Service tab.

      4. Under Isolation mode, clear the Run web service in IIS 5.0 isolation mode check box to enable worker process isolation mode.

    2. Define two application pools; one for website1 and the other for website2. Do not use the predefined application pool DefaultAppPool.

    3. Define the two websites, including the filter setting, virtual host setting, and extension settings.

    4. Assign an application pool for each website.

      1. Under each website folder, right click on the website name.

      2. Click Property, and select the Home Directory tab. 2.

      3. In the application settings, select the application pool you defined for website 1 from the dropdown list of application pools.

      4. Click OK.

      5. Repeat the previous steps for the second website and select the application pool you defined for website 2.

    5. Start the IIS service and start each website.


    Results

    This procedure results in re-configuring the Internet Information Services (IIS) Web Server.

    Note: On some editions of the Windows operating system, the http_plugin.log file is not created automatically when the plug-in is installed and the IIS Web Server is started. If the http_plugin.log file is not created after performing the procedure described above, take the following steps:

    1. Open a Windows Explorer window.

    2. Browse to the plugins_root\logs\web_server_name directory.

    3. Share the folder and give full-control permission to everyone.


    What to do next

    We can now install applications on the configured Web server. See the Applications section of the information center for more information.

    To unconfigure a web server, reverse the manual steps and remove what was manually added in this procedure.