Previous Topic: Unlock the ISAPI Filters Module for Classic Mode Applications with appcmd.exeNext Topic: Add Modules, Handlers and Filters for Integrated Pipeline Mode Applications with Appcmd.exe


Create Virtual Directories for your Agent for IIS with appcmd.exe

The second step for configuring a SiteMinder Agent for IIS manually is creating the virtual directories for SiteMinder on each website of your IIS 7.x web server. The appcmd.exe command (provided by Microsoft) provides a possible example of how to create virtual directories for 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 creating virtual directories for SiteMinder an IIS 7.x server. These directories are normally created by the Configuration wizard. Evaluate your particular implementation and modify any steps accordingly.

Create virtual directories 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. Create the siteminderagent virtual directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/physicalPath:"web_agent_home\samples
    
    your_web_site_name

    Specifies the name of your website, as defined in the IIS Manager.

    Default: Default Web Site

    Limits: If the name contains spaces, enclose it with quotes.

    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

  3. Create the pw virtual directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/pw /physicalPath:"web_agent_home\pw"
    
  4. Create the pwcgi virtual directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/pwcgi/physicalPath:"web_agent_home\pw"
    
  5. Create the jpw virtual directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/jpw/physicalPath:"web_agent_home\jpw"
    
  6. Create the redirectjsp directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/redirectjsp/physicalPath:"web_agent_home\affwebservices\redirectjsp"
    
  7. Create the cert virtual directory with the following comand:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/cert /physicalPath:"web_agent_home\samples"
    
  8. Create the nocert virtual directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/nocert/physicalPath:"web_agent_home\samples"
    
  9. Create the certoptional virtual directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/certoptional/physicalPath:"web_agent_home\samples"
    
  10. Create the ntlm virtual directory with the following command:
    appcmd/commit add vdir/app.name:"your_web_site_name/" /path:/siteminderagent/ntlm/physicalPath:"web_agent_home\samples"
    

    The virtual directories are created.