#
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
#
# Copyright (c) 2007 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.6 2008/08/19 19:15:06 veiming Exp $
#
#
#
------------------------------------------------------------------------------
Installation instructions Open Web Single Sign-On - Web Agents
------------------------------------------------------------------------------

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

%% 1. Agent Installation

Please make sure that the SJS Web Server 7.0/6.x is installed and running. Also
make sure that the SJS Web Server Agent is compiled with steps indicated in README.txt.

Installation does the following:

    - Creates the SJS Web Server Agent Instance Directory
    - Tag Swapping in OpenSSOAgentBootstrap.properties file
    - Updating SJS Web Server's obj.conf, magnus.conf files

%% 1.1 Steps

1.1.1 Extract  sjsws_v70_Linux_agent.zip installation bits.
1.1.2 Goto web_agents/sjsws_agent/bin
1.1.3 Execute agentadmin --install
1.1.4 Accept the license agreement terms
1.1.5 Follow the installation interactions and provide these details:

    - SJS Web Server Config Directory
    - OpenSSO Services Hos
    - OpenSSO Services port
    - OpenSSO Services Protocol
    - OpenSSO Services Deployment URI
    - Agent Host name
    - Agent Host port
    - Agent Host protocol
    - Agent Profile name
    - Agent Profile's plain text password file

1.1.6 Restart the server


Here is the sample of the above steps with Web Server 7.0 :

[/opt]> unzip sjsws_v70_Linux_agent.zip

x web_agents
x web_agents/sjsws_agent
x web_agents/sjsws_agent/bin
x web_agents/sjsws_agent/bin/crypt_util
x web_agents/sjsws_agent/bin/certutil
x web_agents/sjsws_agent/bin/agentadmin
x web_agents/sjsws_agent/bin/agentadmin.bat
x web_agents/sjsws_agent/etc
x web_agents/sjsws_agent/etc/dsame.template
x web_agents/sjsws_agent/config
x web_agents/sjsws_agent/config/OpenSSOAgentBootstrap.template
x web_agents/sjsws_agent/config/AMToolsConfig.properties
x web_agents/sjsws_agent/config/configure.xml
x web_agents/sjsws_agent/lib
x web_agents/sjsws_agent/lib/libxml2.so
x web_agents/sjsws_agent/lib/sjsws-install.jar
x web_agents/sjsws_agent/lib/opensso-installtools.jar
x web_agents/sjsws_agent/lib/opensso-installtools-launcher.jar
x web_agents/sjsws_agent/lib/libames6.so
x web_agents/sjsws_agent/jce
x web_agents/sjsws_agent/jsse
x web_agents/sjsws_agent/locale
x web_agents/sjsws_agent/locale/amToolsMessages.properties
x web_agents/sjsws_agent/locale/sjswsTools.properties
x web_agents/sjsws_agent/license.txt
x web_agents/sjsws_agent/README

[/opt]> cd web_agents/sjsws_agent/bin/

[/opt]> chmod +x agentadmin crypt_util certutil

[/opt/web_agents/sjsws_agent/bin/]> ./agentadmin --install

Do you completely agree with all the terms and conditions of this License
Agreement (yes/no): [no]: yes



Enter the complete path to the directory which is used by SJS Web Server to
store its configuration Files. This directory uniquely identifies the
SJS Web Server instance that is secured by this Agent.
[ ? : Help, ! : Exit ]
Enter the SJS Web Server Config Directory Path []: /var/opt/sun/webserver7/https-agent_hostname/config


Enter the fully qualified host name of the server where OpenSSO
Services are installed.
[ ? : Help, < : Back, ! : Exit ]
OpenSSO Services Host: am.host.com


Enter the port number of the Server that runs OpenSSO Services.
[ ? : Help, < : Back, ! : Exit ]
OpenSSO Services port [80]: 8080


Enter http/https to specify the protocol used by the Server that runs OpenSSO services.
[ ? : Help, < : Back, ! : Exit ]
OpenSSO Services Protocol [http]:


Enter the Deployment URI for OpenSSO Services.
[ ? : Help, < : Back, ! : Exit ]
OpenSSO Services Deployment URI [/amserver]:


Enter the fully qualified host name on which the Web Server protected by the
agent is installed.
[ ? : Help, < : Back, ! : Exit ]
Enter the Agent Host name: agent.host.com


Enter the preferred port number on which the Web Server provides its
services.
[ ? : Help, < : Back, ! : Exit ]
Enter the port number for Web Server instance [80]: 7000


Select http or https to specify the protocol used by the Web server instance
that will be protected by OpenSSO Policy Agent.
[ ? : Help, < : Back, ! : Exit ]
Enter the Preferred Protocol for Web Server instance [http]:


Enter a valid Agent profile name. Before proceeding with the agent
installation, please ensure that a valid Agent profile exists in OpenSSO server. 
[ ? : Help, < : Back, ! : Exit ]
Enter the Agent Profile name [UrlAccessAgent]:


Enter the path to a file that contains the password to be used for identifying
the Agent.
[ ? : Help, < : Back, ! : Exit ]
Enter the path to the password file: /opt/password


-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
SJS Web Server Config Directory : /var/opt/sun/webserver7/https-agent_hostname/config
OpenSSO Services Host : am.host.com
OpenSSO Services Port : 8080
OpenSSO Services Protocol : http
OpenSSO Services Deployment URI : /amserver
Agent Host name : agent.host.com
Web Server Instance Port number : 7000
Protocol for Web Server instance : http
Agent Profile name : UrlAccessAgent
Agent Profile Password file name : /opt/password

Verify your settings above and decide from the choices below.
1. Continue with Installation
2. Back to the last interaction
3. Start Over
4. Exit
Please make your selection [1]:

Creating directory layout and configuring Agent file for Agent_001
instance ...DONE.

Reading data from file /opt/password and encrypting it ...DONE.

Generating audit log file name ...DONE.

Creating tag swapped OpenSSOAgentBootstrap.properties file for instance Agent_001 ...DONE.

Creating a backup for file /var/opt/sun/webserver7/https-agent_hostname/config/obj.conf ...DONE.

Adding Agent parameters to /var/opt/sun/webserver7/https-agent_hostname/config/obj.conf file ...DONE.

Creating a backup for file /var/opt/sun/webserver7/https-agent_hostname/config/magnus.conf ...DONE.

Adding Agent parameters to /var/opt/sun/webserver7/https-agent_hostname/config/magnus.conf file ...DONE.


SUMMARY OF AGENT INSTALLATION
-----------------------------
Agent instance name: Agent_001
Agent Configuration file location:
/opt/web_agents/sjsws_agent/Agent_001/config/OpenSSOAgentBootstrap.properties
Agent Audit directory location:
/opt/web_agents/sjsws_agent/Agent_001/logs/audit
Agent Debug directory location:
/opt/web_agents/sjsws_agent/Agent_001/logs/debug


Install log file location:
/opt/web_agents/sjsws_agent/logs/audit/install.log

Thank you for using OpenSSO Policy Agent


%% 2. Agent Uninstallation

Use agentadmin --uninstall option to uninstall the agent. Uninstallation does
the following:

    - Unconfigures obj.conf, magnus.conf files.
    - Removes agent instance's config directory.

To completely remove the agent installation files, go back to web_agents and
simply remove the directory.


Here is the sample:


[/opt/web_agents/sjsws_agent/bin]> ./agentadmin --uninstall



************************************************************************
Welcome to the OpenSSO Policy Agent for SJS Web Server If the Policy
Agent is used with OpenSSO services, User needs to enter
information relevant to OpenSSO server.

************************************************************************


Enter the complete path to the directory which is used by SJS Web Server to
store its configuration Files. This directory uniquely identifies the
SJS Web Server instance that is secured by this Agent.
[ ? : Help, ! : Exit ]
Enter the SJS Web Server Config Directory Path []: /var/opt/sun/webserver7/https-agent_hostname/config


-----------------------------------------------
SUMMARY OF YOUR RESPONSES
-----------------------------------------------
SJS Web Server Config Directory : /var/opt/sun/webserver7/https-agent_hostname/config

Verify your settings above and decide from the choices below.
1. Continue with Uninstallation
2. Back to the last interaction
3. Start Over
4. Exit
Please make your selection [1]:

Deleting the config directory
/opt/web_agents/sjsws_agent/Agent_001/config ...DONE.

Removing Agent parameters from /var/opt/sun/webserver7/https-agent_hostname/config/obj.conf file ...DONE.

Removing Agent parameters from /var/opt/sun/webserver7/https-agent_hostname/config/magnus.conf file ...DONE.

Uninstall log file location:
/opt/web_agents/sjsws_agent/logs/audit/uninstall.log

Thank you for using OpenSSO Policy Agent
