Sun OpenSSO Enterprise Policy Agent 3.0 Guide for Microsoft Internet Information Services (IIS) 6.0

Creating a Configuration File for the IIS 6.0 Agent

The IIS6CreateConfig.vbs script creates the IIS 6.0 agent configuration file. The IIS6CreateConfig.vbs script prompts you for information and then creates a configuration file that you can use later to configure the IIS 6.0 agent.

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

Note: If you are deploying the IIS 6.0 agent on multiple Web sites, you must create a unique agent configuration file for each of the Web sites.

ProcedureTo Create a Configuration File for the IIS 6.0 Agent

  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

    The \bin directory contains the IIS6CreateConfig.vbs script, which you run to create the agent configuration file.

  3. Create the agent configuration file by issuing the following case-sensitive command:

    cscript IIS6CreateConfig.vbs ConfigFile

    where ConfigFile is the unique name for agent configuration file.

    For example: cscript IIS6CreateConfig.vbs IIS6Config.txt

    The IIS6CreateConfig.vbs script creates this file and then saves your responses to prompts about the agent host and the OpenSSO Enterprise server in the file.

  4. When prompted, provide the following information about the IIS 6.0 server that this agent will protect:

    • Agent Resource File Name: Accept the default value IIS6Resource.en (English version).

    • Agent URL: : Specify the URL for the IIS 6.0 agent including the port number. For example: http://agenthost.example.com:80

    • Web Site Identifier: Specify the unique identifier associated with the Web site for which you are creating a configuration file. Accept a value from the displayed list.

  5. When prompted, provide the following information about the OpenSSO Enterprise host:

    • OpenSSO server URL, including the deployment URI: For example: http://openssohost.example.com:8080/opensso

    • Agent Profile name: For example: IIS6AgentProfile.

    • Agent Profile password File: Path to the file that contains the agent profile password. For example: C:\tmp\IIS6Agentpw.txt


Example 1 Sample IIS6CreateConfig.vbs Script Run

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
---------------------------------------------------------
    Microsoft (TM) Internet Information Server (6.0)
---------------------------------------------------------
Enter the Agent Resource File Name [IIS6Resource.en] :

Enter the Agent URL (Example: http://agent.example.com:80) :
http://agent.example.com:80

Displaying the list of Web Sites and its corresponding Identifiers
Site Name (Site Id)
Default Web Site (1)
testPolicy (204642793)
Test2 (223085047)

Web Site Identifier :
1
------------------------------------------------
Sun OpenSSO Enterprise 8.0
------------------------------------------------
Enter the URL where the OpenSSO server is running. 
Please include the deploymentURI also as shown in the example 
(Example: http://opensso.example.com:58080/opensso):
http://openssohost.example.com:8080/opensso

Please enter the Agent Profile name :
IIS6AgentProfile

Enter the Agent profile password file :
c:\tmp\IIS6Agentpw.txt

-----------------------------------------------------
Agent Configuration file created : IIS6AgentConfig.txt
-----------------------------------------------------