#
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
#
# Copyright (c) 2006 Sun Microsystems Inc. All Rights Reserved
#
# The contents of this file are subject to the terms
# of the Common Development and Distribution License
# (the License). You may not use this file except in
# compliance with the License.
#
# You can obtain a copy of the License at
# https:\\opensso.dev.java.net\public\CDDLv1.0.html or
# opensso\legal\CDDLv1.0.txt
# See the License for the specific language governing
# permission and limitations under the License.
# 
# When distributing Covered Code, include this CDDL
# Header Notice in each file and include the License file
# at opensso\legal\CDDLv1.0.txt.
# If applicable, add the following below the CDDL Header,
# with the fields enclosed by brackets [] replaced by
# your own identifying information:
# "Portions Copyrighted [year] [name of copyright owner]"
#
# $Id: INSTALL.txt,v 1.4 2009/06/26 21:35:23 robertis Exp $
#
#
------------------------------------------------------------------------------
Installation instructions file for Open Web Single Sign-On - Web Agents
------------------------------------------------------------------------------

%% Contents:
    %% 1. Agent Installation
    %% 2. Agent Uninstallation

%% 1. Agent Installation

Please make sure that the IIS 6 Server is installed and running. Also
make sure that the IIS 6 Agent is compiled with steps indicated in README.txt.

Installation does the following:

    - Creates the IIS 6 Agent Instance Directory
    - Tag Swapping in OpenSSOAgentBootstrap.properties file
    - Updating IIS 6 web site: adds agent filter

%% 1.1 Steps

1.1.1 Extract iis_v6_WINNT_agent_3.zip or iis_v6_WINNT_x64_agent_3.zip installation bits.
1.1.2 Goto web_agents\iis6_agent\bin
1.1.3 Execute: cscript.exe IIS6CreateConfig.vbs <config_file>
Follow the installation interactions and provide these details:

    - Agent Host name
    - IIS 6 Web site id
    - Agent Host protocol
    - Agent Host port
    - Agent deployment URI
    - OpenSSO Services Host
    - OpenSSO Services Protocol
    - OpenSSO Services port
    - OpenSSO Services Deployment URI
    - OpenSSO Services Console URI
    - Agent Profile name
    - Password file which contains the Agent Profile password.

1.1.4 Execute: cscript.exe IIS6Admin.vbs -config <config_file>

1.1.5 Restart the server


Here is the sample of the above steps:

[C:\Agents30]>unzip iis_v6_WINNT_agent_3.zip
Archive:  iis_v6_WINNT_agent_3.zip
   creating: web_agents/
   creating: web_agents/iis6_agent/
   creating: web_agents/iis6_agent/bin/
   creating: web_agents/iis6_agent/config/
  inflating: web_agents/iis6_agent/README
  inflating: web_agents/iis6_agent/bin/IIS6Admin.vbs
  inflating: web_agents/iis6_agent/bin/IIS6CreateConfig.vbs
  inflating: web_agents/iis6_agent/bin/IIS6Resource.en
  inflating: web_agents/iis6_agent/bin/Microsoft.VC90.CRT.manifest
  inflating: web_agents/iis6_agent/bin/amiis6.dll
  inflating: web_agents/iis6_agent/bin/amiis6.pdb
  inflating: web_agents/iis6_agent/bin/amsdk.dll
  inflating: web_agents/iis6_agent/bin/amsdk.pdb
  inflating: web_agents/iis6_agent/bin/certutil.exe
  inflating: web_agents/iis6_agent/bin/cryptit.exe
  inflating: web_agents/iis6_agent/bin/freebl3.chk
  inflating: web_agents/iis6_agent/bin/freebl3.dll
  inflating: web_agents/iis6_agent/bin/libnspr4.dll
  inflating: web_agents/iis6_agent/bin/libplc4.dll
  inflating: web_agents/iis6_agent/bin/libplds4.dll
  inflating: web_agents/iis6_agent/bin/libxml2.dll
  inflating: web_agents/iis6_agent/bin/msvcm90.dll
  inflating: web_agents/iis6_agent/bin/msvcp71.dll
  inflating: web_agents/iis6_agent/bin/msvcp90.dll
  inflating: web_agents/iis6_agent/bin/msvcr71.dll
  inflating: web_agents/iis6_agent/bin/msvcr90.dll
  inflating: web_agents/iis6_agent/bin/nss3.dll
  inflating: web_agents/iis6_agent/bin/smime3.dll
  inflating: web_agents/iis6_agent/bin/softokn3.chk
  inflating: web_agents/iis6_agent/bin/softokn3.dll
  inflating: web_agents/iis6_agent/bin/ssl3.dll
  inflating: web_agents/iis6_agent/bin/vc70.pdb
  inflating: web_agents/iis6_agent/config/OpenSSOAgentBootstrap.template
  inflating: web_agents/iis6_agent/config/OpenSSOAgentConfiguration.template
  inflating: web_agents/iis6_agent/config/OpenSSOAgentMigration.properties
  inflating: web_agents/iis6_agent/license.txt


[C:\Agents30]> cd web_agents\iis6_agent\bin\

[C:\Agents30\web_agents\iis6_agent\bin]>cscript IIS6CreateConfig.vbs agentconfig.txt
Microsoft (R) Windows Script Host Version 5.6
Copyright (C) Microsoft Corporation 1996-2001. All rights reserved.


Copyright c 2007 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] :

Fully Qualified Host Name :
agent.host.com

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

Agent Protocol [http] :


Agent Port Number [80] :


Agent Deployment URI [/amagent] :

------------------------------------------------
Sun OpenSSO Enterprise 8.0
------------------------------------------------
Primary Server Host :
opensso.host.com

Primary Server Protocol [http] :


Primary Server Port Number [58080] :
8080

Primary Server Deployment URI [/opensso] :


Please enter the Agent Profile name :
agent1

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

-----------------------------------------------------
Agent Configuration file created ==>  agentconfig.txt
Execute the below command for Agent Configuration :
      cscript.exe IIS6Admin.vbs -config agentconfig.txt
-----------------------------------------------------



[C:\Agents30\web_agents\iis6_agent\bin]>cscript IIS6Admin.vbs -config agentconfig.txt
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.prop
erties File
Updating the Windows Product Registry
Loading the IIS 6.0 Agent
Completed Configuring the IIS 6.0 Agent


Configures IIS web site, given above, with the agent ISAPI extension.


%% 2. Agent Uninstallation

2.1. Remove the Agent ISAPI extension from the configured IIS web site.

	cscript.exe IIS6Admin.vbs -unconfig <config_file>

Sample:

[C:\Agents30\web_agents\iis6_agent\bin]>cscript IIS6Admin.vbs -config agentconfig.txt
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.prop
erties File
Updating the Windows Product Registry
Loading the IIS 6.0 Agent
Completed Configuring the IIS 6.0 Agent


2.2 Remove the web_agents/ directory.


