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.

You must have selected the “IIS Plugin” option (or Client Runtime option) during the installation for the required files to be extracted. You can restart the installation program and add this option if needed.

Installing and configuring the IIS 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.

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

Install the appropriate libraries into the dll_location directory. See “Installing libraries from EAServer to your Web server”.

Add the dll_location directory to the system path.

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

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

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

Open the IIS Administrative Tool.
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.

Configure the ISAPI filter:

Highlight the Web site where you want to install the plug-in, right-click, and select Properties.
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
```
Click OK.

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

Highlight the Web site where you installed libjeas_iis.dll, right-click, and select New | Virtual Directory.
Specify the alias:
```
Alias: Sybase
```

Specify the directory:

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

Specify the permissions:

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

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

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
```
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
```

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

Verify that the ISAPI filter is working correctly:

Highlight the Web site where you want to install the plug-in, right-click, and select Properties.
On the ISAPI Filters tab, verify that the status for the new filter (Sybase) is a green arrow pointing upward.
If you see the green arrow, click OK, and move to the next test.
If you do not see a green arrow, step through the instructions for the ISAPI filter again. Look for errors and other mismatches.

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