Configuring the IIS 6.0 Agent for a Web Site

The IIS6Admin.vbs script configures the IIS 6.0 agent for a specific Web site, based on an agent configuration file created by the IIS6CreateConfig.vbs script.

You must have Administrator privileges to run the IIS6Admin.vbs script.

The IIS6Admin.vbs script performs these functions:

• Creates a subdirectory named Identifier_id under the web_agents\iis6_agent directory, where id is the Web site identifier. This directory contains the IIS 6.0 agent's \config and \logs directories.

• Creates the OpenSSOAgentBootstrap.properties and OpenSSOAgentConfiguration.properties files for the IIS 6.0 agent using the agent configuration file created by the IIS6CreateConfig.vbs script.

• Updates the Windows registry with the location of properties file.

• Adds the wildcard ISAPI extension to the Web site for which the agent is configured.

Note: To configure the IIS 6.0 agent for multiple Web sites, follow this procedure for each Web site, using a unique agent configuration file for each site.

To Configure the IIS 6.0 Agent for a Web Site

1. On the Windows 2003 Server instance, open a command window. For example, click Start, Run, and then type cmd.

2. Change to the PolicyAgent-base\bin directory.

   where PolicyAgent-base depends where you unzipped the IIS 6.0 agent distribution file. For example:

   For example: C:\Agents\web_agents\iis6_agent\bin

3. Configure the Web site for the IIS 6.0 agent by running the IIS6Admin.vbs script with the -config option.

   For example: cscript IIS6Admin.vbs -config IIS6AgentConfig.txt

   where IIS6Config.txt is the agent configuration file that you created in Creating a Configuration File for the IIS 6.0 Agent.

   Notes:

   • The script name and options are case-sensitive.

   • For the Agent Resource File Name prompt, accept the default value (IIS6Resource.en).

   The IIS6Admin.vbs script displays the progress of the configuration, as shown in the following sample:

   Microsoft (R) Windows Script Host Version 5.6
   Copyright (C) Microsoft Corporation 1996-2001. All rights reserved.
   
   Copyright c 2009 Sun Microsystems, Inc. All rights reserved
   Use is subject to license terms
   
   Enter the Agent Resource File Name [IIS6Resource.en] :
   
   Creating the Agent Config Directory
   Creating the OpenSSOAgentBootstrap.properties 
       and OpenSSOAgentConfiguration.properties File
   Updating the Windows Product Registry
   Loading the IIS 6.0 Agent
   Completed Configuring the IIS 6.0 Agent

4. Ensure that the IIS 6.0 authentication method is set to Anonymous.

5. Restart IIS 6.0 using the iisreset command. For example, in a command prompt, type iisreset.

Next Steps

To view the agent log file (amAgent), see PolicyAgent-base\debug\Identifier_site-identifier\logs\debug, where site-identifier is a number such as 1 that identifies the Web site where the IIS 6.0 agent is being configured.