Appeon Mobile Tutorials (Mobile only)
Task 4: Configure the Web server for the Appeon Server cluster

Installing Appeon Server Web component to the Web root of the IIS server.

Make sure you have installed Appeon Server Web Component to the Web root of the IIS server. To verify it, go to the IIS Web root (by default C:\inetpub\wwwroot) and check if there is an appeon folder which at least contains the IISSupport and weblibrary_ax sub-folders. If any folder is missing, go to the default installation directory of Appeon Server Web Component (C:\Program Files\Appeon\WebComponent2015) and manually copy the entire appeon folder 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, "ApbCluster".

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

Step 5: Click OK.

Figure 67. Add virtual directory

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

Step 7: Choose the Security tab, and then click the Edit button.

Figure 68. ApbCluster properties

Step 8: Select IIS_IUSRS, for example, IIS_IUSRS (HUANGXUXIA\IIS_IUSRS) from the Group or user names list, and then select the Allow check box for Modify and Write in the Permissions for IIS_IUSRS list.

Figure 69. ApbCluster permissions

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

Copying the Appeon plug-in (ApbCluster.dll or ApbCluster64.dll).

Copy the ApbCluster.dll (for 32-bit OS) or ApbCluster64.dll (for 64-bit OS) plug-in from appeon\IISSupport\modules to the newly created virtual directory (C:\inetpub\wwwroot\ApbCluster in this guide).

In the 64-bit OS, you can either use ApbCluster.dll or ApbCluster64.dll. If you use ApbCluster.dll, you will need to set the Enable 32-Bit Applications to True for the application pool used by the current Web site. If you use ApbCluster64.dll, then set this option to False.

Creating the Appeon cluster configuration file (cluster-config.xml).

Create the cluster-config.xml file in the newly created virtual directory (C:\inetpub\wwwroot\ApbCluster in this guide). The cluster-config.xml file acts as the redirector configuration file which helps the Web server redirect requests to the Appeon Servers according to the IP addresses/ports of Appeon Servers, and the load balancing algorithm that it stores.

<?xml version="1.0" encoding="UTF-8" ?>
<cluster-config local="true" log="debug" timeout="30" polling="5" arithmetic="sequence">
    <extention>/ApbCluster/ApbCluster.dll</extention>
    <filters>
        <filter>/AEM</filter>
        <filter>/servlet</filter>
        <filter>/reportfile</filter>
        <filter>/imagefile</filter>
        <filter>/dwfile</filter>
        <filter>/ajsdown</filter>
    </filters>
    <app-servers>
        <app-server host="192.0.0.168" port="88" />
        <app-server host="192.0.3.131" port="80" />
        <app-server host="192.0.3.145" port="80" />
    </app-servers>
</cluster-config>

Notes:

Installing the Appeon plug-in as ISAPI Filters.

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

Step 2: Select 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 ApbCluster in the Filter name box and specify ApbCluster.dll (or ApbCluster64.dll) as the ISAPI filter in the Executable box (C:\inetpub\wwwroot\ApbCluster\ApbCluster.dll in this guide). Click OK.

Figure 70. Add ISAPI filter

Copying the redirector configuration file (ApbCluster.cfg).

Copy the ApbCluster.cfg redirector configuration file from appeon\IISSupport\conf\ to the virtual directory (C:\inetpub\wwwroot\ApbCluster in this guide) and edit the file when necessary.

Extension_URI=/ApbCluster/ApbCluster.dll   
MatchExpression=/AEM
MatchExpression=/servlet
MatchExpression=/reportfile
MatchExpression=/imagefile
MatchExpression=/dwfile
MatchExpression=/ajsdown
Log=On

Notes:

Setting ISAPI and CGI Restrictions.

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

Step 2: Select the local machine (the top node), 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 ApbCluster.dll (or ApbCluster64.dll) in the ISAPI or CGI path box and input the descriptive text in the Description box, and then select Allow extension path to execute.

Step 5: Click OK.

Figure 71. Add ISAPI or CGI

Enabling ISAPI-dll.

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

Step 2: Expand Default Web Site, select ApbCluster, 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 72. Edit feature permissions

​

Adding MIME type for loading the pages without extension names or pages without MIME types defined.

Step 1: Select 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:

Step 4: Click OK.

Figure 73. Add MIME type

Restarting IIS.

Restart IIS to make the new settings effective.

Installing Appeon Server Web component to the Web root of the IIS server.

Make sure you have installed Appeon Server Web Component to the Web root of the IIS server. To verify it, go to the IIS Web root (by default C:\inetpub\wwwroot) and check if there is an appeon folder which contains the IISSupport and weblibrary_ax sub-folders. If any folder is missing, go to the default installation directory of Appeon Server Web Component (C:\Program Files\Appeon\WebComponent2015) and manually copy the entire appeon folder to the IIS Web root.

Specifying the properties of IIS Web site.

Step 1: Open Control Panel | Administrative Tools | Internet Service Manager.

Step 2: Right click Web Sites | Default Web Site and select Properties.

Step 3: In the Default Web Site Properties window, select the Home Directory tab and set the Execute permissions to Scripts only.

Figure 74. Web site properties

Creating the virtual directory.

Step 1: Right click the Default Web Site and select New | Virtual Directory.

Step 2: Input the alias name (for example, "ApbCluster"), and select a mapping directory (for example, "d:\iisplugin").

Step 3: Allow the following permissions for the mapping directory: Read, Run scripts (such as ASP), and Execute (such as ISAPI application or CGI)

Figure 75. Virtual directory

Copying the Appeon plug-in.

Copy the ApbCluster.dll (for 32-bit OS) or ApbCluster64.dll (for 64-bit OS) plug-in from appeon\IISSupport\modules to the newly created virtual directory (d:\iisplugin in this guide) .

In the 64-bit OS, you can either use ApbCluster.dll or ApbCluster64.dll. If you use ApbCluster.dll, you will need to set the Enable 32-Bit Applications to True for the application pool used by the current Web site. If you use ApbCluster64.dll, then set this option to False.

Creating the Appeon cluster configuration file (cluster-config.xml).

Create the cluster-config.xml file in the newly created virtual directory (d:\iisplugin in this guide). The cluster-config.xml file acts as the redirector configuration file which helps the Web server redirect requests to the Appeon Servers according to the IP addresses/ports of Appeon Servers, and the load balancing algorithm that it stores.

<?xml version="1.0" encoding="UTF-8" ?>
<cluster-config local="true" log="debug" timeout="30" polling="5" 
arithmetic="sequence">
    <extention>/ApbCluster/ApbCluster.dll</extention>
    <filters>
        <filter>/AEM</filter>
        <filter>/servlet</filter>
        <filter>/reportfile</filter>
        <filter>/imagefile</filter>
        <filter>/dwfile</filter>
        <filter>/ajsdown</filter>
    </filters>
    <app-servers>
        <app-server host="192.0.0.168" port="88" />
        <app-server host="192.0.3.131" port="80" />
        <app-server host="192.0.3.145" port="80" />
    </app-servers>
</cluster-config>

Notes:

Installing IIS filter.

Step 1: Right click Default Web Site and select Properties.

Step 2: In the Default Web Site Properties window, select the ISAPI Filters tab. Click Add to add ApbCluster.dll (or ApbCluster64.dll) as the ISAPI filter. Click OK.

Copying the redirector configuration file (ApbCluster.cfg).

Copy the ApbCluster.cfg redirector configuration file from appeon\IISSupport\conf\ to the virtual directory (d:\iisplugin in this guide) and edit the file when necessary.

Extension_URI=/ApbCluster/ApbCluster.dll   
MatchExpression=/AEM
MatchExpression=/servlet
MatchExpression=/reportfile
MatchExpression=/imagefile
MatchExpression=/dwfile
MatchExpression=/ajsdown
Log=On

Notes:

Activating ISAPI.

Step 1: Select the Web Services Extension. The ISAPI status will be displayed on the right.

Step 2: Select All Unknown ISAPI Extensions and click the Allow button.

Figure 76. Allow ISAPI

Adding new MIME type.

Step 1: Right click the Local computer and select Properties.

Step 2: In the properties window, click the MIME Types button. In the MIME Types window, click New.

Input the following information:

This is to ensure that pages without extension names or pages without MIME types defined can be accessed.

Figure 77. MIME Types

Restarting IIS.

Restart IIS to make the new settings effective.

Installing Appeon Server Web component to the Web root of the IIS server.

Make sure you have installed Appeon Server Web Component to the Web root of the IIS server. To verify it, go to the IIS Web root (by default C:\inetpub\wwwroot) and check if there is an appeon folder which contains the IISSupport and weblibrary_ax sub-folders. If any folder is missing, go to the default installation directory of Appeon Server Web Component (C:\Program Files\Appeon\WebComponent2015) and manually copy the entire appeon folder 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 Default Web Site and select Add Virtual Directory.

Step 3: Input the alias name, for example, "ApbCluster".

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

Step 5: Click OK.

Figure 78. Add virtual directory

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

Step 7: Choose the Security tab page and then click the Edit button.

Figure 79. appeoncluster properties

Step 8: Select IIS_IUSRS, for example, IIS_IUSRS (HUANGXUXIA\IIS_IUSRS) from the Group or user names list, and then select the Allow check box for Modify and Write in the Permissions for IIS_IUSRS list.

Figure 80. appeoncluster properties

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

Copying the Appeon plug-in (ApbCluster.dll or ApbCluster64.dll).

Copy the ApbCluster.dll (for 32-bit OS) or ApbCluster64.dll (for 64-bit OS) plug-in from appeon\IISSupport\modules to the newly created virtual directory (C:\inetpub\wwwroot\ApbCluster in this guide).

In the 64-bit OS, you can either use ApbCluster.dll or ApbCluster64.dll. If you use ApbCluster.dll, you will need to set the Enable 32-Bit Applications to True for the application pool used by the current Web site. If you use ApbCluster64.dll, then set this option to False.

Creating the Appeon cluster configuration file (cluster-config.xml).

Create the cluster-config.xml file in the newly created virtual directory (C:\inetpub\wwwroot\ApbCluster in this guide). The cluster-config.xml file acts as the redirector configuration file which helps the Web server redirect requests to the Appeon Servers according to the IP addresses/ports of Appeon Servers, and the load balancing algorithm that it stores.

<?xml version="1.0" encoding="UTF-8" ?>
<cluster-config local="true" log="debug" timeout="30" polling="5" arithmetic="sequence">
    <extention>/ApbCluster/ApbCluster.dll</extention>
    <filters>
        <filter>/AEM</filter>
        <filter>/servlet</filter>
        <filter>/reportfile</filter>
        <filter>/imagefile</filter>
        <filter>/dwfile</filter>
        <filter>/ajsdown</filter>
    </filters>
    <app-servers>
        <app-server host="192.0.0.168" port="88" />
        <app-server host="192.0.3.131" port="80" />
        <app-server host="192.0.3.145" port="80" />
    </app-servers>
</cluster-config>

Notes:

Installing the Appeon plug-in as ISAPI Filters.

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

Step 2: Select 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 ApbCluster in the Filter name box and specify ApbCluster.dll (or ApbCluster64.dll) as the ISAPI filter in the Executable box (C:\inetpub\wwwroot\ApbCluster\ApbCluster.dll in this guide). Click OK.

Figure 81. Add ISAPI filter

Copying the redirector configuration file (ApbCluster.cfg).

Copy the ApbCluster.cfg redirector configuration file from appeon\IISSupport\conf\ to the virtual directory (C:\inetpub\wwwroot\ApbCluster in this guide) and edit the file when necessary.

Extension_URI=/ApbCluster/ApbCluster.dll   
MatchExpression=/AEM
MatchExpression=/servlet
MatchExpression=/reportfile
MatchExpression=/imagefile
MatchExpression=/dwfile
MatchExpression=/ajsdown
Log=On

Notes:

Setting ISAPI and CGI Restrictions.

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

Step 2: Select the local machine (the top node), 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 ApbCluster.dll (or ApbCluster64.dll) in the ISAPI or CGI path box and input the descriptive text in the Description box, and then select Allow extension path to execute.

Step 5: Click OK.

Figure 82. Add ISAPI or CGI

Enabling ISAPI-dll.

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

Step 2: Expand Default Web Site, select ApbCluster, 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 83. Edit feature permissions

Adding MIME type for loading the pages without extension names or pages without MIME types defined.

Step 1: Select 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:

Step 4: Click OK.

Figure 84. Add MIME type

Restarting IIS.

Restart IIS to make the new settings effective.

Installing Appeon Server Web component to the Web root of the IIS server.

Make sure you have installed Appeon Server Web Component to the Web root of the IIS server. To verify it, go to the IIS Web root (by default C:\inetpub\wwwroot) and check if there is an appeon folder which contains the IISSupport and weblibrary_ax sub-folders. If any folder is missing, go to the default installation directory of Appeon Server Web Component (C:\Program Files\Appeon\WebComponent2015) and manually copy the entire appeon folder to the IIS Web root.

Specifying the properties of the IIS Web site.

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: Click the Home Directory tab and select Scripts only from the Execute Permissions dropdown list.

Figure 85. Default Web site properties

Creating a virtual directory.

Step 1: Right click Default Web Site and select New.

Step 2: Click the Virtual Directory tab and input ApbCluster in the Application name box.

Step 3: Choose a local path; for example, d:\iisplugin.

Step 4: Enable read, run script, and execute on the virtual directory. Or select Read and selecting Scripts and Executables from the Execute Permissions dropdown list.

Figure 86. Apbcluster properties

Copying the Appeon plug-in.

Copy the ApbCluster.dll (for 32-bit OS) or ApbCluster64.dll (for 64-bit OS) plug-in from appeon\IISSupport\modules to the virtual directory: d:\iisplugin.

In the 64-bit OS, you can either use ApbCluster.dll or ApbCluster64.dll. If you use ApbCluster.dll, you will need to set the Enable 32-Bit Applications to True for the application pool used by the current Web site. If you use ApbCluster64.dll, then set this option to False.

Creating the Appeon cluster configuration file (cluster-config.xml).

Create the cluster-config.xml file in the newly created virtual directory (d:\iisplugin in this guide). The cluster-config.xml file acts as the redirector configuration file which helps the Web server redirect requests to the Appeon Servers according to the IP addresses/ports of Appeon Servers, and the load balancing algorithm that it stores.

<?xml version="1.0" encoding="UTF-8" ?>
<cluster-config local="true" log="debug" timeout="30" polling="5" arithmetic="sequence">
    <extention>/ApbCluster/ApbCluster.dll</extention>
    <filters>
        <filter>/AEM</filter>
        <filter>/servlet</filter>
        <filter>/reportfile</filter>
        <filter>/imagefile</filter>
        <filter>/dwfile</filter>
        <filter>/ajsdown</filter>
    </filters>
    <app-servers>
        <app-server host="192.0.0.168" port="88" />
        <app-server host="192.0.3.131" port="80" />
        <app-server host="192.0.3.145" port="80" />
    </app-servers>
</cluster-config>

Notes:

Installing Appeon plug-in as ISAPI Filters.

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

Step 2: Right click Default Web Site and choose Properties.

Step 3: Click the ISAPI Filters tab. Click Add to add ApbCluster.dll (or ApbCluster64.dll). Click OK.

Copying the redirector configuration file (ApbCluster.cfg).

Copy the ApbCluster.cfg redirector configuration file from appeon\IISSupport\conf\ to the virtual directory:d:\iispulgin, and edit the file when necessary.

Extension_URI=/ApbCluster/ApbCluster.dll   
MatchExpression=/AEM
MatchExpression=/servlet
MatchExpression=/reportfile
MatchExpression=/imagefile
MatchExpression=/dwfile
MatchExpression=/ajsdown
Log=On

Notes:

Enabling Web Services Extension.

Step 1: Click Web Services Extension in the IIS Manager.

Step 2: Select All Unknown ISAPI Extensions and click the Allow button.

Adding MIME type for loading the pages without extension names or pages without MIME types defined.

Step 1: Right click the Local computer and select Properties.

Step 2: Click the MIME Types button.

Step 3: Click the New button and specify the following settings:

Figure 87. MIME Type

Restarting IIS.

Restart IIS to make the new settings effective.

Installing Appeon Server Web component to the document root of the Apache Web server.

Make sure you have installed Appeon Server Web Component to the document root of the Apache Web server. To verify it, go to the Apache document root (by default %APACHE%\htdocs) and check if there is an appeon folder which contains the Apache20Support, Apache22Support and weblibrary_ax sub-folders. If any folder is missing, go to the default installation directory of Appeon Server Web Component (C:\Program Files\Appeon\WebComponent2015) and manually copy the entire appeon folder to the Apache document root.

Copying Appeon plug-in.

Copy the mod_appeon2.so or mod_appeon22.so plug-in file from %APACHE%\htdocs\appeon\Apache2xSupport\modules to the %APACHE%\modules folder.

Copying Appeon Cluster configuration file.

Copy the cluster-config.xml file from the %appeon%\repository\<instancename>\config folder to the %APACHE%\conf folder, where %appeon% is the installation directory of Appeon Server, and <instancename> refers to the name of the Appeon Server instance.

Note: The cluster-config.xml file acts as the redirector configuration file which helps the Web server redirect requests to Appeon Servers according to the IP addresses/ports of Appeon Servers, and the load balancing algorithm that it stores. This file should not be modified manually as it will be automatically updated when you change the settings in the Cluster tool of AEM. Each time after you change the settings, be sure to copy this file and replace the old file in the %APACHE%\conf folder and restart Apache.

Modifying httpd.conf.

If the application server (such as EAServer, WebLogic, WebSphere, JBoss, or JEUS) is running on Windows, add the following statements into the httpd.conf file under the %APACHE%\conf folder (take mod_appeon2.so as an example):

LoadModule appeon_module modules\mod_appeon2.so
<IfModule mod_appeon.c>
MatchExpression /AEM
MatchExpression /servlet
MatchExpression /reportfile
MatchExpression /imagefile
MatchExpression /dwfile
MatchExpression /ajsdown
</IfModule>

If the application server is running on UNIX/LINUX, add the following statements into the httpd.conf file under the %APACHE%\conf folder (take mod_appeon2.so as an example):

LoadModule appeon_module modules/mod_appeon2.so
<IfModule mod_appeon.c>
MatchExpression /AEM
MatchExpression /servlet
MatchExpression /reportfile
MatchExpression /imagefile
MatchExpression /dwfile
MatchExpression /ajsdown
</IfModule>

Restarting Apache.

Restart Apache for the new settings to take effect.

Installing Appeon Server Web component to the document root of the Apache Web server.

Make sure you have installed Appeon Server Web Component to the document root of the Apache Web server. To verify it, go to the Apache document root (by default %APACHE%\htdocs) and check if there is an appeon folder which contains the Apache20Support, Apache22Support and weblibrary_ax sub-folders. If any folder is missing, go to the default installation directory of Appeon Server Web Component (C:\Program Files\Appeon\WebComponent2015) and manually copy the entire appeon folder to the Apache document root.

Copying Appeon plug-in.

Copy the mod_appeon.so plug-in file from %APACHE%\htdocs\appeon\Apache13Support\modules to the %APACHE%\modules folder.

Copying Appeon Cluster configuration file.

Copy the cluster-config.xml file from the %appeon%\repository\<instancename>\config folder to the %APACHE%\conf folder, where %appeon% is the installation directory of Appeon Server, and <instancename> refers to the name of a server instance.

Note: The cluster-config.xml file acts as the redirector configuration file which helps the Web server redirect requests to Appeon Servers according to the IP addresses/ports of Appeon Servers, and the load balancing algorithm that it stores. This file should not be modified manually as it will be automatically updated when you change the settings in the Cluster tool of AEM. Each time after you change the settings, be sure to copy this file and replace the old file in the %APACHE%\conf folder and restart Apache.

Modifying httpd.conf.

Add the following statements into the httpd.conf file under the %APACHE%\conf folder:

LoadModule appeon_module modules\mod_appeon.so
<IfModule mod_appeon.c>
MatchExpression /AEM
MatchExpression /servlet
MatchExpression /reportfile
MatchExpression /imagefile
MatchExpression /dwfile
MatchExpression /ajsdown
</IfModule>

Restarting Apache.

Restart Apache for the new settings to take effect.