Problem:

• Product: BES5.2.1 - Internet Information Server (IIS)
• Platform: Windows
• JDK:1.4.1

HOW TO SETUP/ENABLE IISREDIR?

Resolution:

The following are supplimentary instuctions to the information provided in the BES Developers guide, on the install/enable of IISREDIR on your Internet Information Server (IIS).

1) create a unique directory supposed to contain IISREDIR related driver and configuration files. For example: $ mkdir c:\\iisredir
NOTE: if you plan to use an existing BES installation you may skip this step and step 2)

2) from an existing BES installation copy files listed below into mentioned into directory created in step 1) bin/orb_r.dll bin/vport_r.dll bin/issredir.dll var/servers/$server/iisredir/conf/UriMapFile.properties var/servers/$server/issredir/conf/WebClusters.properties
NOTE: this are essentially all files required to run IISREDIR.

3) adjust registry Your registry needs to be adjusted according to directory created in step 1)
NOTE: you don't need to do this in case you are using an existing BES installation. The installation of BES will create necessary registry entries for you.
---- iisredir.reg
----------------------------------- REGEDIT4 [HKEY_LOCAL_MACHINE\\SOFTWARE\\Borland\\Enterprise\\IIS-IIOP Redirector\\1.0] "ClusterConfig"="C:\\\\iisredir\\\\WebClusters.properties" "LogFile"="C:\\\\iisredir\\\\iisredir.log" "LogLevel"="debug" "MajorVersion"="01" "MinorVersion"="01" "UriMapFile"="C:\\\\iisredir\\\\UriMapFile.properties" "extension_uri"="/borland/iisredir.dll" [HKEY_LOCAL_MACHINE\\SOFTWARE\\Borland\\Enterprise\\License] "CurrentVersion"="5.2" [HKEY_LOCAL_MACHINE\\SOFTWARE\\Borland\\Enterprise\\VisiBroker] "CurrentVersion"="5.2" [HKEY_LOCAL_MACHINE\\SOFTWARE\\Borland\\Enterprise\\VisiBroker\\5.2] "CurrentVersion"="5.2" "OSAGENT_PORT"="14197"
----------------------------------------------------- Here we have IISREDIR installed in C:\\iisredir, loglevel set to debug and OSAGENT_PORT is set to 14197. Please make necessary changes reflecting your installation, then import this file into registry. Especially you may change the value of key OSAGENT_PORT!

4) Open your IIS managment console.

5) Create a new virtual directory Essentially this virtual directory needs to
5a) be named "borland"
5b) point to directory created in step 1 (c:/iisredir)
5c) have permissions to execute scripts etc.
You create a new virtual directory by right click into "Default Web Site" and choosing New | Virtual Directory.
This will pop up a wizard which will guide you.
NOTE: please use "borland" for it's name. You may be able to choose another name but this would involve hacking the registry (key "extension_uri", see step 3) above).

6) Add ISAPI filter "iisredir" Take console opened in step 3), right click on your web server ("Default Web Site") and choose Properties.
Now add filter "iisredir" into ISAPI: iisredir -> c:\\iisredir\\iisredir.dll Then close window and reopen this window.
You should see now that your new filter is properly loaded.

7) Make sure that BES is running in your subnet. Especially check that BES-Tomcat is running.
To this, please run osfind on a machine of your choice. If you observe osfind's output you should see some- thing like

$ osfind
...
REPOSITORY ID: IDL:apache/ReqProcessor:1.0 OBJECT NAME: tc_inst1
...

This "tc_inst1" is essentially Tomcat (at least from a IISREDIR point of view).

8) Restart IIS To restart IIS please go to IIS management console, right click on "Internet Information Services" and choose "Restart IIS".

9) Please check again that ISAPI filter "iisredir" is up and running.

10) Take your browser and point it to http://examples and this should display very much the same as http://:8080/examples namely a directory listing of the examples.war web application (enabled by default).