Configuring IIS with JEUS

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 PowerServer Web Component to the IIS Web root

Run the Appeon setup program and install PowerServer 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 PowerServer Web Component to another location, then you should copy the entire "appeon" folder from the installation directory of PowerServer Web Component to the IIS Web root.

Installing the redirector plug-in

  1. Download the redirector plug-in (for example, isapi_redirect-1.2.10.exe) from the Apache Website (http://archive.apache.org/dist/jakarta/tomcat-connectors/jk/binaries/win32). Install the redirector plug-in to the default installation directory (for example, C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector).

  2. Open Control Panel | Administrative Tools | Internet Service Manager.

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

  4. On the Home Directory tab, select Scripts only from the Execute Permissions dropdown list box.

  5. On the ISAPI Filters tab, click Add, and install the redirector plug-in as an ISAPI filter. Filters are invoked in the order they are listed. Appeon recommends that the redirector plug-in be installed first in the list. Click OK.

    For example,

    Filter Name: jakarta

    Executable: C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\bin\RedirectorPlug-in. RedirectorPlug-in indicates the name of the redirector plug-in, for example, isapi_redirect.dll.

  6. Restart IIS for the new configuration to take effect. Go to the ISAPI Filters tab and verify that the redirector plug-in is loaded successfully (indicated by a green arrow pointing upward while a red arrow pointing downward indicates that the DLL file was not successfully loaded).

Modifying the configuration files

  1. Modify the uriworker.properties file in the "conf" folder under the default installation directory of the redirector plug-in (e.g. C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\conf):

    For single PowerServer:

    # uriworker.properties - 
    # 
    # This file provides sample mappings for example 
    # ajp13w worker defined in workermap.properties.minimal
    
    /AEM=ajp13w
    /AEM/*=ajp13w
    /servlet=ajp13w
    /servlet/*=ajp13w
    
    # Now filter out all .jpeg files inside that context 
    # For no mapping the url has to start with exclamation (!) 
    
    !/servlets-examples/*.jpeg=ajp13w

    For multiple PowerServer implementing load balancing:

    # uriworkermap.properties - IIS
    #
    # This file provides sample mappings for example wlb
    # worker defined in workermap.properties.minimal
    # The general syntax for this file is:
    # [URL]=[Worker name]
    /AEM=cluster
    /AEM/*=cluster
    /servlet =cluster
    /servlet/*=cluster
  2. Modify the workers.properties.minimal file in the "conf" folder under the default installation directory of the redirector plug-in:

    # 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=ajp13w
    #
    # Defining a worker named ajp13w and of type ajp13
    # Note that the name and the type do not have to match.
    #
    worker.ajp13w.type=ajp13
    worker.ajp13w.host=192.0.2.217    #for configuring the IP address of JEUS. 
    worker.ajp13w.port=8009    #for configuring the AJP port. The default is 8009. 
    worker.ajp13w.cachesize=200

    For multiple PowerServer implementing load balancing:

    The following script example shows that there are two JEUS application servers participating in load balancing, and their node names are jiangzepeng and zhangjungang respectively. You can replace them with the real node names of JEUS application servers and add similar scripts to involve other JEUS application servers.

    # workers.properties.minimal -
    #
    worker.list=jiangzepeng_servlet_engine1,zhangjungang_servlet_engine1,cluster
    
    worker.cluster.type=lb
    worker.cluster.balance_workers=jiangzepeng_servlet_engine1,zhangjungang
    _servlet_engine1
    
    worker.jiangzepeng_servlet_engine1.port=8009
    worker.jiangzepeng_servlet_engine1.host=192.168.168.35
    worker.jiangzepeng_servlet_engine1.type=ajp13
    worker.jiangzepeng_servlet_engine1.lbfactor=1
    worker.jiangzepeng_servlet_engine1.cachesize=200
    
    worker.zhangjungang_servlet_engine1.port=8009
    worker.zhangjungang_servlet_engine1.host=192.168.168.217
    worker.zhangjungang_servlet_engine1.type=ajp13
    worker.zhangjungang_servlet_engine1.lbfactor=1
    worker.zhangjungang_servlet_engine1.cachesize=200

    For detailed information on how to configure the directives in workers.properties.minimal, visit http://tomcat.apache.org/connectors-doc/reference/workers.html.

Additional configuration for IIS

  1. Activate ISAPI:

    • 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.

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

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

    • Select the HTTP Header tab and click the MIME Types button.

    • Click the New button to add a MIME type.

      For example:

      Extension: *

      MIME type: application/octet-stream

Restarting IIS and JEUS

Restart IIS and JEUS for the new settings to take effect.