Redirector Not Working

Checking for redirector failure

To check the failure of the redirector first you will need to go to your machine’s browser (NOT the server’s browser) and use the machine name or the DNS name to go to the server, with the tomcat folder specified.

Example

http://coursemill.com/cm6/

If this works than there is no failure in the redirector. If it fails, then try the same address with :8080 after the machine name or DNS name.

http://coursemill.com:8080/cm6/

If the first does not work, but the :8080 version of the address works, this is surely a failure in the redirector.

Diagnosing the issue

To find out if this document will help you, you will need to to first do the following:

  1. Make sure IIS is running and configured to work on port 80.

  2. Make sure tomcat is running.

  3. Make sure only one version of Java is installed and running.

Checking IIS

Open Internet Information Service (IIS) manager, choose your website that you have configured for CourseMill. In Advanced Setting (or where site Bindings are defined) make sure your IIS is using port 80.

Also make sure IIS and the site is running in the Manage Web Site section.

Checking Tomcat

To find out if tomcat is running, go to Start > Apache Tomcat X.X > Configure Tomcat. You will see a window with Tomcat’s Status displayed.

What version is configured to work with CourseMill

There are a few places where Java is configured to work with Tomcat and CourseMill.

If Tomcat was installed in the default location, you should find the worker.Properties file in the C:\Program Files\Apache Software Foundation\Tomcat 7.0\conf\ folder. In the Workers.properties file around line 47 you will find a variable named workers.java_home, this is where CourseMill will find the version of Java that it will use.

If Tomcat is installed in the default location you will find the Tomcat Configuration tool at C:\Program Files\Apache Software Foundation\Tomcat 7.0\bin\tomcat7w.exe In the Java tab of this tool you can define the Java Virtual Machine. Here you will want to see what folder the bin\client\jvm.dll file is in.

Java6 will be in C:\Program Files\Java\jre6 folder
Java5 will be in C:\Program Files\Java\jre1.5.X_XX

If you see two versions of Java Installed, see CourseMill and Java.

Determining if Java is Running

Open the Command Prompt window and type java –version then press Return. You should see something like this:

Java6 will show “1.6.X_XX
Java5 will show “1.5.X_XX

Checking Tomcat Redirect Settings

In the conf subdirectory in the Tomcat root directory, you should see the iis_redirect.reg, workers.properties, and uriworkermap.properties files. If you don’t see these three files, get you CD and copy the missing files into this directory.

Edit the iis-redirect.reg file in a text editor, make sure that the tomcat folder paths are correct in this file. If you made an update to the paths, save the file and execute the file.

Edit the workers.properties file in a text editor and make sure that workers.tomcat_home and workers.java_home are configured to the appropriate directories.

Checking IIS Redirect settings

Verify that there is a "SCRIPTS" Virtual Directory set up for your web site. (If not create one by right-clicking on the appropriate web site and select New and Virtual Directory). The "SCRIPTS" Virtual Directory should point to the c:\Inetpub\Scripts folder and should have Scripts and Executable permissions.

Make sure that isapi_redirect.dll is in the scripts folder.

Verify that isapi_redirect.dll is added as a filter in your IIS web site. The name of the filter should be Tomcat, its executable must be the isapi_redirect.dll that you just put in the scripts directory.

Verify that there is a Web Service Extension to allow the Tomcat ISAPI Filter to function. In the IIS Manager right-click on the Web Service Extensions and the name should be Tomcat ISAPI Filter, the required file is c:\Inetpub\Scripts\isapi_redirect.dll, and make sure that the box Set extension status to Allowed for this extension.

You should now be able to go to the machine name or the DNS name to go to the server, with the tomcat folder specified without the :8080 in the address.