Manual installation

On Windows Server 2008

Global installation into GAC

1. Add C:\Program Files\Helicon\Ape\Helicon.Ape.dll to GAC

gacutil.exe/i Helicon.Ape.dll

or simply drag Helicon.Ape.dll to C:\Windows\assembly using Windows Explorer.

2. Add the following code into C:\Windows\System32\inetsrv\config\applicationHost.config:

<system.webServer>

  <handlers accessPolicy="Read, Script">

    <!-- Proxy handler -->
    <add name="Helicon.Ape Handler" path="*.apehandler" verb="*"
      type="Helicon.Ape.Handler, Helicon.Ape, Version=1.XX.XX.XX, Culture=neutral, PublicKeyToken=95bfbfd1a38437eb"
      resourceType="Unspecified" preCondition="integratedMode" />

  </handlers>

  <modules>
    
    <!-- Filter itself -->
    <add name="Helicon.Ape" type="Helicon.Ape.ApeModule, Helicon.Ape, Version=1.XX.XX.XX, Culture=neutral, 
    PublicKeyToken=95bfbfd1a38437eb" />
    
  </modules>

</system.webServer>

Note! 'XX.XX.XX' in Version variable should be replaced with current Helicon Ape version number.

3. Set the following value for the registry key

HKEY_LOCAL_MACHINE\SOFTWARE\Helicon\Ape [InstallDir] = C:\Program Files\Helicon\Ape\

At the specified path Helicon Ape will take settings (httpd.conf) and create logs.

Single site installation

1. Copy C:\Program Files\Helicon\Ape\Helicon.Ape.dll into <Site>/Bin folder.

2. Add registration into C:\inetpub\wwwroot\web.config.

To register in web.config type attribute may be specified partially.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>

    <modules>
      <add name="Helicon.Ape" type="Helicon.Ape.ApeModule" />
    </modules>
    
    <handlers>
      <add name="Helicon.Ape Handler" path="*.apehandler" verb="*" type="Helicon.Ape.Handler"
        resourceType="Unspecified" preCondition="integratedMode" />

    </handlers>

  </system.webServer>
</configuration>

3. All Helicon Ape settings must be stored in <Site>/Helicon/httpd.conf

Snap-in installation

1. Add C:\Program Files\Helicon\Ape\Helicon.Ape.Snapin.dll into GAC

2. Add C:\Program Files\Helicon\Ape\Helicon.Ape.Editor.dll into GAC

3. Add registration into C:\Windows\System32\inetsrv\config\administration.config

<configuration>
  <moduleProviders>
    <add name="Helicon Ape" type="Helicon.Ape.Snapin.ApeManagementModuleProvider, 
    Helicon.Ape.Snapin, Version=1.XX.XX.XX, Culture=neutral, PublicKeyToken=95bfbfd1a38437eb" />
  </moduleProviders>
</configuration>

4. Run «Internet Information Services (IIS) Manager».

On Windows Server 2003

Global installation into GAC

1. Add C:\Program Files\Helicon\Ape\Helicon.Ape.dll to GAC

2. Add into C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\CONFIG\web.config:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.web>
    <httpModules>
      <add name="Helicon.Ape" type="Helicon.Ape.ApeModule, Helicon.Ape, 
        Version=1.0.XX.XX, Culture=neutral, PublicKeyToken=95bfbfd1a38437eb" />
      </httpModules>
        
      <httpHandlers>
        <add path="*.apehandler" verb="*"
          type="Helicon.Ape.Handler, Helicon.Ape, Version=1.XX.XX.XX, Culture=neutral, PublicKeyToken=95bfbfd1a38437eb"
          validate="false" />
      </httpHandlers>

  </system.web>
</configuration>

Note! 'xx' in Version variable should be replaced with current Helicon Ape version number.

3. Set the following value for the registry key

HKEY_LOCAL_MACHINE\SOFTWARE\Helicon\Ape [InstallDir] = C:\Program Files\Helicon\Ape\

At the specified path Helicon Ape will take settings (httpd.conf) and create logs.

4. To make the module work with requests other than .*.aspx, please set mapping.

Single site installation

1. Copy C:\Program Files\Helicon\Ape\Helicon.Ape.dll into <Site>/Bin folder.

2. Add registration into C:\inetpub\wwwroot\web.config.

To register in web.config type attribute may be specified partially.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.web>
  
    <httpModules>
      <add name="Helicon.Ape" type="Helicon.Ape.ApeModule" />
    </httpModules>
    
    <httpHandlers>
      <add path="*.apehandler" verb="*" type="Helicon.Ape.Handler" validate="false" />
    </httpHandlers>
    
  </system.web>
</configuration>

3. All Helicon Ape settings must be stored in <Site>/Helicon/httpd.conf