Configuring IIS with JBoss

Configuring IIS 7.x with JBoss

The Default Web Site of the IIS server is used as examples in this section. You can choose another existing Web site, or create a new Web site.

Installing Appeon Server Web Component to the IIS Web root

Run the Appeon setup program and install Appeon Server Web Component to the Web root of the IIS Web site, for example, the Web root for the Default Web site is C:\Inetpub\wwwroot.

If you have installed Appeon Server Web Component to another location, then you should copy the entire "appeon" folder from the installation directory of Appeon Server Web Component to the IIS Web root.

Creating a virtual directory

Step 1: Open Control Panel | Administrative Tools | Internet Information Service (IIS) Manager.

Step 2: Right click the Default Web Site and select Add Virtual Directory.

Step 3: Input the alias name, for example, jakarta.

Step 4: Choose a local path in the Physical path box, for example, C:\inetpub\wwwroot\jakarta.

Step 5: Click OK.

Figure 12. Add virtual directory

Add virtual directory


Step 6: Right click the jakarta virtual directory and select Edit Permissions.

Step 7: Choose the Security tab page, select IIS_IUSRS (WIN-TDTR6ISIYCD\IIS_IUSRS) in the Group or user names list box, and then click the Edit button.

Figure 13. jakarta properties

jakarta properties


Step 8: Select IIS_IUSRS (WIN-TDTR6ISIYCD\IIS_IUSRS) in the Group or user names list box, and then select Modify and Write in the Allow column of the Permissions for IIS_IUSRS list box.

Figure 14. permissions for jakarta

permissions for jakarta


Step 9: Click OK to go back to the IIS window.

Copying plug-in (isapi_redirect.dll)

Step 1: Download the required plug-in from http://archive.apache.org/dist/jakarta/tomcat-connectors/jk/binaries/win32.

Step 2: Paste it to the newly created virtual directory: C:\inetpub\wwwroot\jakarta in this section.

Installing plug-in as ISAPI Filters

Step 1: Open Control Panel | Administrative Tools | Internet Information Service (IIS) Manager.

Step 2: Click the Default Web Site and then double-click ISAPI Filters on the right side.

Step 3: Right-click the blank area on the ISAPI Filters page, and click Add.

Step 4: Input jakarta in the Filter name box and select isapi_redirect.dll as the ISAPI filter in the Executable box (C:\inetpub\wwwroot\jakarta\isapi_redirect.dll in this section). Click OK.

Figure 15. Add ISAPI filter

Add ISAPI filter


Creating the redirector configuration file

Step 1: Go to %IIS_REDIRECT%\conf. %IIS_REDIRECT% indicates the location of the plug-in.

Step 2: In %IIS_REDIRECT%\conf, create the uriworker.properties file and add the following scripts to it:

# uriworker.properties -
#
# This file provides sample mappings for example
# ajp13w worker defined in workermap.properties.minimal
/AEM/*=node1
/servlet/*=node1
/AEM=node1
/servlet=node1

Step 3: In %IIS_REDIRECT%\conf, create the workers.properties.minimal file and add the following scripts to it:

# workers.properties.minimal -
#
# This file provides minimal jk configuration properties needed to
# connect to Tomcat.
#
# The workers that jk should create and work with
#
worker.list= node1
#
# Defining a worker named node1 and of type ajp13
# Note that the name and the type do not have to match.
#
worker. node1.type=ajp13
# IP of JBoss server
worker. node1.host=192.0.2.217
# ajp13 port of JBoss server
worker. node1.port=8009
Setting ISAPI and CGI Restrictions

Step 1: Open Control Panel | Administrative Tools | Internet Information Service (IIS) Manager.

Step 2: Right-click the local machine, and then double-click ISAPI and CGI Restrictions on the right side.

Step 3: Right-click the blank area of the ISAPI and CGI Restrictions page and click Add.

Step 4: Specify the local path of isapi_redirect.dll in the ISAPI or CGI path box and input jakarta in the Description box, and then select Allow extension path to execute.

Step 5: Click OK.

Figure 16. Add ISPAPI or CGI restriction

Add ISPAPI or CGI restriction


Enabling ISAPI-dll

Step 1: Open Control Panel | Administrative Tools | Internet Information Service (IIS) Manager.

Step 2: Expand the Default Web Site, click jakarta, and then double-click Handler Mappings on the right side.

Step 3: Right-click ISAPI-dll, and select Edit Feature Permissions.

Step 4: Select Read, Script, Execute, and click OK.

Figure 17. Edit feature permissions

Edit feature permissions


Adding MIME type

Add a MIME type for loading the files with no extensions or MIME type definition.

Step 1: Click the Default Web Site and then double-click MIME Types on the right of the page.

Step 2: Right-click the blank area of the MIME Types page, and click Add.

Step 3: Specify the following settings:

  • Extension: *

  • MIME Type: application/octet-stream

Step 4: Click OK.

Figure 18. Add MIME type

Add MIME type


Restarting IIS

Restart IIS to make the new settings effective.

Configuring for DataWindow Data Cache

The DataWindow data cache feature is not available in IIS 7.x.

Configuring IIS 6.0 with JBoss

The Default Web Site of the IIS server is used as examples in this section. You can choose another existing Web site, or create a new Web site.

Step 1: Run the Appeon setup program and install Appeon Server Web Component to the Web root of the IIS Web site, for example, the Web root for the Default Web site is C:\Inetpub\wwwroot.

If you have installed Appeon Server Web Component to another location, then you should copy the entire "appeon" folder from the installation directory of Appeon Server Web Component to the IIS Web root.

Step 2: Download the required plug-in from http://archive.apache.org/dist/jakarta/tomcat-connectors/jk/binaries/win32.

Step 3: Create a virtual directory: In the IIS manager, right click Default Web Site, select New | Virtual Directory, input jakarta as the virtual directory name, point the path to %IISHome%\bin, and select Execute for the virtual directory.

Step 4: Add the ISAPI filter: In the IIS manager, right click Default Web Site, select Properties | ISAPI Filters | Add, input the following:

  • Filter Name: jakarta

  • Executable: %IIS_REDIRECT%/bin/isapi_redirect.dll

%IIS_REDIRECT% indicates the installation directory of the plug-in.

Step 5: In %IIS_REDIRECT%\conf, create the uriworker.properties file, and add the following scripts to it:

# uriworker.properties -
#
# This file provides sample mappings for example
# ajp13w worker defined in workermap.properties.minimal
/AEM/*=node1
/servlet/*=node1
/AEM=node1
/servlet=node1

Step 6: In %IIS_REDIRECT%\conf, create the workers.properties.minimal file, and add the following scripts to it:

# workers.properties.minimal -
#
# This file provides minimal jk configuration properties needed to
# connect to Tomcat.
#
# The workers that jk should create and work with
#
worker.list= node1
#
# Defining a worker named ajp13w and of type ajp13
# Note that the name and the type do not have to match.
#
worker.node1.type=ajp13
# IP of JBoss server
worker.node1.host=192.0.2.217
# ajp13 port of JBoss server
worker.node1.port=8009

Step 7: Add a MIME type for loading the DataWindow files (for IIS 6.0 only): In the IIS manager, right click Default Web Site, select Properties | HTTP Headers | MIME Types, input the following:

  • Extension: dat

  • MIME type: text/html

Step 8: Activate the ISAPI filter: Open the IIS manager, click Web Service Extensions on the left side of IIS manager, select All Unknown ISAPI extensions on the right of the window and click the Allow button on the left.

Configuring for DataWindow Data Cache for IIS 6

Under the installation directory of Appeon Server Web Component (for example, C:\Inetpub\wwwroot\appeon), there is an IISSupport folder.

  1. Copy the appeoncache.conf file from the IISSupport\conf folder and the AppDataBuf.dll file from the IISSupport\modules folder to the same folder, for example, C:\Inetpub\scripts.

  2. If necessary, adjust the cache size in the appeoncache.conf file (The unit is MB).

  3. Open Control Panel | Administrative Tools | Internet Information Services Manager.

  4. Right click the Default Web Site and select Properties from the popup menu.

  5. On the ISAPI Filters tab, click Add, and install AppDataBuf.dll as an ISAPI filter. Click OK.

    For example,

    Filter name: appeon_cache

    Executable: C:\Inetpub\scripts\AppDataBuf.dll

  6. On the Service tab, select the Run WWW service in IIS 5.0 isolation mode option.

  7. Restart IIS for the new configuration to take effect.