Log in to the server where you want to install the agent.
Important: To install the agent, you must have write permission to the files and directories for the Web Proxy Server 4.0.x instance.
Stop the Web Proxy Server 4.0.x instance.
Change to the PolicyAgent-base/bin directory. For example:
/opt/web_agents/proxy40_agent/bin
Start the agent installation. For example:
# ./agentadmin --custom-install
On Windows systems, run the agentadmin.bat program.
Enter information as requested by the agentadmin program, or accept the default values displayed by the program.
After you have made your choices, the agentadmin program displays a summary of your responses. For example:
----------------------------------------------- SUMMARY OF YOUR RESPONSES ----------------------------------------------- Sun Java System Proxy Server Config Directory : /opt/sun/proxyserver40/proxy-server1/config OpenSSO server URL : http://opensso-host.example.com:8080/opensso Agent URL : http://agent-host.example.com:8090 Agent Profile name : WPS4Agent Agent Profile Password file name : /tmp/wps4agentpw 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]:
Verify your choices and either continue with the installation (selection 1, the default) , or make any necessary changes.
If you continue, the program installs the agent and displays a summary of the installation. For example:
SUMMARY OF AGENT INSTALLATION ----------------------------- Agent instance name: Agent_001 Agent Bootstrap file location: /opt/web_agents/proxy40_agent/Agent_001/config/OpenSSOAgentBootstrap.properties Agent Configuration Tag file location /opt/web_agents/proxy40_agent/Agent_001/config/OpenSSOAgentConfiguration.properties Agent Audit directory location: /opt/web_agents/proxy40_agent/Agent_001/logs/audit Agent Debug directory location: /opt/web_agents/proxy40_agent/Agent_001/logs/debug
After the installation finishes successfully, if you wish, check the installation log file in the PolicyAgent-base/installer-logs/audit directory:
Restart the Web Proxy Server 4.0.x instance that is being protected by the policy agent.
************************************************************************ Welcome to the OpenSSO Policy Agent for Sun Java System Proxy Server. ************************************************************************ Enter the complete path to the directory which is used by Sun Java System Proxy Server to store its configuration Files. This directory uniquely identifies the Sun Java System Proxy Server instance that is secured by this Agent. [ ? : Help, ! : Exit ] Enter the Sun Java System Proxy Server Config Directory Path [/opt/sun/proxyserver40/proxy-server1/config]: Enter the URL where the OpenSSO server is running. Please include the deployment URI also as shown below: (http://opensso.sample.com:58080/opensso) [ ? : Help, < : Back, ! : Exit ] OpenSSO server URL: http://opensso-host.example.com:8080/opensso Enter the Agent URL as shown below: (http://agent1.sample.com:1234) [ ? : Help, < : Back, ! : Exit ] Agent URL: http://agent-host.example.com:8090 Enter the Agent profile name [ ? : Help, < : Back, ! : Exit ] Enter the Agent Profile name: WPS4Agent 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: /tmp/wps4agentpw ----------------------------------------------- SUMMARY OF YOUR RESPONSES ----------------------------------------------- Sun Java System Proxy Server Config Directory : /opt/sun/proxyserver40/proxy-server1/config OpenSSO server URL : http://opensso-host.example.com:8080/opensso Agent URL : http://agent-host.example.com:8090 Agent Profile name : WPS4Agent Agent Profile Password file name : /tmp/wps4agentpw 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 /tmp/wps4agentpw 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 /opt/sun/proxyserver40/proxy-server1/config/obj.conf ...DONE. Adding Agent parameters to /opt/sun/proxyserver40/proxy-server1/config/obj.conf file ...DONE. SUMMARY OF AGENT INSTALLATION ----------------------------- Agent instance name: Agent_001 Agent Bootstrap file location: /opt/web_agents/proxy40_agent/Agent_001/config/ OpenSSOAgentBootstrap.properties Agent Configuration Tag file location /opt/web_agents/proxy40_agent/Agent_001/config/ OpenSSOAgentConfiguration.properties Agent Audit directory location: /opt/web_agents/proxy40_agent/Agent_001/logs/audit Agent Debug directory location: /opt/web_agents/proxy40_agent/Agent_001/logs/debug Install log file location: /opt/web_agents/proxy40_agent/installer-logs/audit/install.log Thank you for using OpenSSO Policy Agent. INSTALL NOTE: Installer modifies obj.conf file in the config directory you specified. UNINSTALL NOTE: Uninstall removes agent settings from obj.conf file in the config directory you specified. If there are multiple obj.conf files configured manually in the same config directory, then please remove them manually. For more information, please refer agent documentation.