Web Server Configuration Guide
Configuring for single PowerServer

Installing PowerServer Web component to the Web root of the IIS server.

Make sure you have installed PowerServer 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 PowerServer Web Component (C:\Program Files\Appeon\WebComponent2020) 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.

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

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

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.

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) or directly copy this file from the PowerServer AEM configuration folder (for example C:\inetpub\wwwroot\appeon\AEM\config\cluster-config.config) after configuring the cluster in AEM. The cluster-config.xml file acts as the redirector configuration file which helps the Web server redirect requests to the PowerServer according to the IP addresses/ports of PowerServer, 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>
    <app-servers-https>
        <app-server-https id="2218220616687201197240" host="172.16.8.10" port="443" />
    </app-servers-https>
</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.

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.

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.

​

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.

Restarting IIS.

Restart IIS to make the new settings effective.