Chapter 4, “Installing and Configuring a Web Server Redirector Plug-In”

Your EAServer installation includes files that implement the IIS Web server plug-in; you must copy these files to the IIS host machine.

1. Create the location on the Web server host for the plug-in files, for example:

   • <plugin_location> c:\winnt\system32\inetsrv\iisplugin

   • <dll_location> plugin_location\dll

2. Install the appropriate libraries into the dll_location directory. See “Installing libraries from EAServer to your Web server” section in the EAServer Installation Guide for Windows.

3. Add the dll_location directory to the system path.

4. Create a text file called iis_redirector.cfg in the plugin_location and copy the following lines into the file. This becomes the starting point for your redirector configuration file:

   Connector.IIS.Extension_URI /sybase/libjeas_iis.dll
   Connector.IIS.URLS /myWebApp
   Connector.IIS.LogFile c:\winnt\system32\inetsrv\iisplugin\redirector.log
   Connector.LogLevel error
   Connector.WebApp /myWebApp =http://myJaguarMachine:8000
   

5. Create the WSPLUGIN_CONFIG_FILE system environment variable and set its value to the iis_redirector.cfg configuration file created in the previous step. To do this, open the System Properties dialog box, create the WSPLUGIN_CONFIG_FILE variable, and set it to the full path of the configuration file:

   WSPLUGIN_CONFIG_FILE c:\winnt\system32\inetsrv\iisplugin\iis_redirector.cfg
   

6. Install the IIS plug-in into IIS – your “IIS Plugin” includes the libjeas_iis.dll file that implements the IIS Web server plug-in:

   1. Open the IIS Administrative Tool.

   2. On Windows, select Control Panel | Administrative Tools | Internet Service Manager.

      Alternately, you can select Control Panel | Administrative Tools | Computer Management | Services and Applications | Internet Information Services.

7. Configure the ISAPI filter:

   1. Highlight the Web site where you want to install the plug-in., right-click, and select Properties.

   2. On the ISAPI Filters tab, click Add, and install libjeas_iis.dll as an ISAPI filter. Filters are invoked in the listed order, so if you install more than one filter, libjeas_iis.dll should be first in the list.

      Filter Name: Sybase
      Executable: C:\WINNT\system32\inetsrv\iisplugin\dll\libjeas_iis.dll
      

   3. Click OK.

8. Create and configure the virtual directory that corresponds to the location of the libjeas_iis.dll directory:

   1. Highlight the Web site where you installed libjeas_iis.dll, right-click, and select New | Virtual Directory.

   2. Specify the alias:

      Alias: Sybase
      

   3. Specify the directory:

      Directory: C:\WINNT\system32\inetsrv\iisplugin\dll
      

   4. Specify the permissions:

      Enable read, run scripts, and execute permissions on the virtual directory.
      

9. Enable ISAPI-dll in Handler Mapping

   1. Highlight the Web site where you installed libjeas_iis.dll and select Handler Mapping.

   2. Select ISAPI-dll handler, click the Edit Feature Permissions, and select the Execute Permission option.

10. Configure ISAPI and CGI Restrictions.

    1. Select the hostname node and select ISAPI and CGI Restrictions.

    2. Right-click and select Add ISAPI and CGI Restriction ISAPI and CGI path:

        C:\WINNT\system32\inetsrv\iisplugin\dll\libjeas_iis.dll
       

        Description: Sybase Inc
       

    3. Enable the Allow extension path to execute option.

11. Edit the configuration file for your specific environment and system. Using a text editor, open the configuration file, plugin_location\iis_redirector.cfg.

    1. Configure static information. These settings are generic to your redirector and do not change as you add or modify Web applications.

       1. Set the Extension_URI to the DLL under the virtual directory:

          Connector.IIS.Extension_URI /sybase/libjeas_iis.dll
          

       2. Set Connector.IIS.LogFile:

          Connector.IIS.LogFile C:\WINNT\system32\inetsrv\iisplugin\redirector.log
          

       3. Set Connector.LogLevel:

          Connector.LogLevel error
          

    2. Configure Web application-specific information, which is dependent on the Web applications you are redirecting, and changes as you add or modify Web applications.

       1. Set Connector.IIS.URLS to a comma-separated list of your Web applications:

          Connector.IIS.URLS /myWebApp1, /myWebApp2
          

       2. Set Connector.WebApp, which maps each redirected Web application to an EAServer instance:

          Connector.WebApp /myWebApp1=http://eas1:8000
          Connector.WebApp /myWebApp2=http://eas2:8000
          

12. Reboot the Web server machine for the environment changes to take effect.

13. Test the redirector with a browser—enter the IIS URL followed by the Web application path. For example, if your settings are:

    IIS URL:   http://myIIS
    Web Application Context: /myWebApp1
    Web Application page: login.jsp
    

    You should be able to reach login.jsp with:

    http://myIIS/myWebApp1/login.jsp