This document outlines the steps involved in setting up and configuring an integration of IIS7 and JBoss 5.
Prerequisite: IFS Applications must be installed with JBoss. In the following steps, IFS_HOME will represent the application server install directory. Microsoft Internet Information Services (IIS) version 7.0 should also be installed on the server.
NOTE: This guide contains steps to manually alter configuration files. It is best recommended that you backup such files prior to doing any alterations.
Merge the registry file isapi_redirect.reg found in IFS_HOME\instance\INSTANCE_NAME\conf\iis\registry with the Windows registry by right-clicking on the file in Windows Explorer and choosing Merge. Then click "Yes" to verify that you want to import the information to the registry.
Start the Internet Information Services (IIS) Manager application. (Start Menu > Administrative Tools > Internet Information Services (IIS) Manager)
Select ISAPI and CGI Restrictions on the server Node level. Add a new ISAPI and CGI restriction. The ISAPI or CGI path must be IFS_HOME\jboss-eap-5.1\jboss-as\native\sbin\isapi_redirect.dll and the Description is jakarta. Allow extension path to execute.
Select Handler Mappings on the server Node level. Right click on ISAPI-dll and select Edit Feature Permissions...
Select/Check Read, Script and Execute and the press OK.
Start the Internet Information Services (IIS) Manager application. (Start Menu > Administrative Tools > Internet Information Services (IIS) Manager)
Select the web site you want to use for Extended Server, for example Default Web Site, and click on Basic Settings. Enter the Physical path. Select the www-root directory in IFS_HOME\instance\<instance_name> as home directory.
Locate the web site from the site tree navigator, Right click > Edit Binding ...
Set the port to match the JBoss instance
Select ISAPI Filter on the Web Site level.
Add a new filer, the Filter Name must be jakarta and the Executable is IFS_HOME\jboss-eap-5.1\jboss-as\native\sbin\isapi_redirect.dll.
Select Authentication on the Web Site level.
Make sure only the Anonymous Authentication option is enabled.
Right click on the Web Site and add the following Virtual Directories.
Virtual Directory Alias Physical Path client client IFS_HOME\jboss-eap-5.1\jboss-as\server\<instance_name>\deploy\ROOT.war\client web client <site_name> IFS_HOME\instance\<instance_name>\webclient\www-root\<site_name> jakarta jakarta IFS_HOME\jboss-eap-5.1\jboss-as\native\sbin
In order to increase performance of IFS Web Client we need to enable Content expiration for the Web Client static content. Select HTTP Response Headers for the Web Client virtual directory(s).
Select Set Common Headers, Enable/Check Expire Web Content and set After: to 30 days.
Select Handler Mappings on the Client Node level. Right click on ISAPI-dll and select Edit Feature Permissions...
Unselect/Uncheck Execute and the press OK.
Select MIME Types on the Client Node level. Add/Edit following file name extensions.
File name extension MIME Type .config application/xml .manifest application/manifest .appsettings application/xml
Request filtering role service is enabled by default in IIS 7. However if it is disabled enable it first using Server Manager.
Select Request Filtering on the Client Node level. Click File name extensions tab. See if extension .config appears there. If it appears remove the "deny" flag.
Make sure that Apache is not started on the same port as IIS.
Restart the Web Site by right clicking on the Web Site and selecting Manage Web Site and then Restart.
Also make sure that the JBoss Application Server is up and running before connecting with client applications.
