Tutorial: installing the IIS plug-in on Windows

This tutorial steps you through the process of installing and testing the redirector plug-in for IIS.

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

     You need to create only the iisplugin and iisplugin\dll directories.

2. Copy the following DLLs from your c:\Program Files\Sybase\EAServer\dll subdirectory into the dll_location directory:

   • libjcc.dll

   • libjctssecct.dll

   • libjeas_iis.dll

   • libjintl.dll

   • libjsybscl.dll

   • libjtml.dll

   • libjutils.dll

   • nlwnsck.dll

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:8080
   

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 EAServer installation 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. 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:8080
         Connector.WebApp /myWebApp2=http://eas2:8080
         

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

11. Verify that the ISAPI filter is working correctly:

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

    2. On the ISAPI Filters tab, verify that the status for the new filter (Sybase) is a green arrow pointing upward.

    3. If you see the green arrow, click OK, and move to the next test.

    4. If you do not see a green arrow, step through the instructions for the ISAPI filter again. Look for errors and other mismatches.

12. 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