Configure Microsoft Internet Information Services (IIS)

This topic describes manual configuration settings for Internet Information Services (IIS).

 

Before you begin

When you install the Web server plug-ins for WebSphere Application Server, as described in Installing Web server plug-ins, the Plug-ins installation wizard configures the Web server. This topic describes how to configure the Internet Information Services (IIS) Web server. Other procedures in Editing Web server configuration files describe configuring other supported Web servers.

You must have read/write access to the plugins_install_root directory to perform this task.

 

Overview

Use the following procedure to manually reproduce how the Installation wizard configures the Microsoft Internet Information Services Web server.

 

Steps for this task (dependent on configuration)

  • Configure IIS V5.0.

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

    2. Expand the tree on the left until you see Default Web Site. Right-click Default Web Site, then click New > Virtual Directory to create the directory with a default installation.

    3. Type sePlugins in the Alias to be used to Access Virtual Directory field.

    4. Browse to the WAS install_root\bin directory in the Enter the physical path of the directory containing the content you want to publish field.

    5. Select the Allow Execute Access check box in the What access permissions do you want to set for this directory field.

    6. Click Finish to add the sePlugins virtual directory to your default Web site.

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

    8. Right-click the host name in the tree on the left and click Properties.

      In the Properties dialog, perform the following steps:

      1. Click the Internet Information Services tab.

      2. Click WWW Service in the Master properties window.

      3. Click Edit to open the WWW Service master properties window.

      4. Click ISAPI Filters > Add to open the Filter properties window.

      5. Type iisWASPlugin in the Filter Name field.

      6. Click Browse in the Executable field.

      7. Browse to the Plugins_install_root\bin directory.

      8. Click the iisWASPlugin_http.dll file.

      9. Click OK until all the open windows close.

  • Configure IIS V6.0.

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

    2. Expand the tree on the left until you see Default Web Site. Right-click Default Web Site, then click New > Virtual Directory to create the directory with a default installation.

    3. Type sePlugins in the Alias to be used to Access Virtual Directory field.

    4. Browse to the plugins_install_root \bin\IIS_ Web_servername directory in the Enter the physical path of the directory containing the content you want to publish field.

    5. Select the appropriate Execute check box (such as ISAPI applications or CGI) in the What access permissions do you want to set for this directory field.

    6. Click Next to add the sePlugins virtual directory to your default Web site.

    7. Click Finish.

    9. Right-click Default Web Site in the tree on the left and click Properties.

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

      In the Properties panel, perform the following steps:

      1. Click the ISAPI Filters tab.

      2. Click Add to open the Filter properties window.

      3. Type iisWASPlugin in the Filter Name field.

      4. Click Browse in the Executable field.

      5. Browse to the plugins_install_root \bin\IIS_ Web_servername directory.

      6. Click the iisWASPlugin_http.dll file.

      7. Click OK until all the open windows close.

    10. If necessary, copy the plug-in binaries to the plugins_install_root \bin\IIS_ Web_servername directory.

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

    11. If necessary, set the value of the Plugin Config variable to the location of the configuration file, which is the plugins_install_root \config\ webservername \plugin-cfg.xml directory.

      The location varies, depending on how you have configured your 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 a managed node, 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 stand-alone example:

      "C:\IBM\WebSphere\AppServer\profiles\default\config\cells\
       sa_cell\nodes\webserver1_node\servers\webserver1\plugin-cfg.xml"

      Remote example:

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

    12. Configure the Web server to run WebSphere Application Server extensions:

      1. Expand the tree on the left until you see Web service extensions.

      2. Click Web service extensions.

      3. Click All Unknown ISAPI extensions on the right side of the page.

      4. Click Allow.

  • Optional: Configure multiple Web sites. Given:

    • There are two Web sites defined: website1, 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 file.

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

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

      2. Right-click the Web Sites folder, click Properties, and then click the Service tab.

      3. 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 pre-defined 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 Web site folder, right click on the Web site name.

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

      3. At the bottom of the application settings, select the application pool you defined for website1 from the drop-down list of application pools.

      4. Click OK.

      5. Repeat the previous steps for the second Web site and select the application pool you defined for website2.

    5. Start the IIS service and start each Web site.

 

Result

This procedure results in reconfiguring the Internet Information Services (IIS) Web server.

 

What to do next

After configuring a Web server, one can install applications on it. See the Applications section of the information center for more information.