Installation and Upgrade Guides › Web Agent Installation Guide for IIS › Configure a SiteMinder Agent for IIS or Web Agent on an IIS Web Server › How to Configure a SiteMinder Agent for IIS Manually › Unlock Modules and Handlers for Integrated Pipeline Mode Applications with appcmd.exe

Unlock Modules and Handlers for Integrated Pipeline Mode Applications with appcmd.exe

The first step for configuring a SiteMinder Web Agent for IIS manually is unlocking the modules and handlers of the IIS 7.x web server. The appcmd.exe command (provided by Microsoft) provides one possible example of how to unlock modules and handlers for configuring a Web Agent manually.

Important! CA provides this information only as an example of one possible method of configuring SiteMinder without using the programs and utilities tested and approved by CA. Microsoft provides the appcmd.exe command as part of the IIS web server. You may choose to use the following examples as a guide to configure your SiteMinder Web Agent for IIS. This command and the syntax shown are subject to change by Microsoft at any time and without notice. For more information, go to the IIS website, and search for "appcmd".

This procedure describes an example of unlocking the IIS module and handlers for applications using Integrated pipeline mode on an IIS 7.x server. Evaluate your particular implementation and modify any steps accordingly.

To unlock modules and handlers for Integrated Pipeline Mode applications with appcmd.exe

1. Open a Command Prompt Window on your IIS web server.

   Important! Before running a SiteMinder utility or executable on Windows Server 2008, open the command line window with administrator permissions. Open the command line window this way, even if your account has administrator privileges.

2. Unlock the handler section of the configuration file with the following command:

   appcmd/commit unlock config-section:system.webServer/handlers
   

3. Unlock the modules section of the configuration file with the following command:

   appcmd/commit unlock config-section:system.webServer/modules
   

4. Add the SiteMinder module for IIS 7.x with the following command:

   appcmd/commit install module /name:CASiteMinderWebagentModule/image:"web_agent_home\bin\IIS7WebAgent.dll" /preCondition:integratedMode
   

   web_agent_home

   Indicates the directory where the SiteMinder Agent is installed on your web server.

   Default (Windows 32-bit installations of SiteMinder IIS Web Agents only): C:\Program Files\CA\webagent

   Default (Windows 64-bit installations [SiteMinder Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

   Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SiteMinder Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

   The modules and handlers for Integrated Pipeline Mode applications are unlocked.