Login to the server where you want to install the agent.
Important: To install the agent, you must have write permission to the WebLogic Server/Portal 10 agent container files and directories.
Change to the following directory:
PolicyAgent-base/bin
On Solaris and Linux systems, set the permissions for the agentadmin program as follows, if needed:
# chmod 755 agentadmin
Stop the WebLogic Server/Portal 10 container.
Start the agent installation:
Default installation: ./agentadmin --install
or
Custom installation: ./agentadmin --custom-install
On Windows systems, run the agentadmin.bat program.
Enter information as requested by the agentadmin program, or accept the default values.
After you have made your choices, the agentadmin program displays a summary of your responses. For example, for an --custom-install installation:
----------------------------------------------- SUMMARY OF YOUR RESPONSES ----------------------------------------------- Startup script location : /opt/bea/user_projects/domains/base_domain/startWebLogic.sh WebLogic Server instance name : AdminServer WebLogic home directory : /opt/bea/wlserver_10.0 OpenSSO Enterprise URL : http://openssohost.example.com:58080/opensso Agent Installed on Portal domain : false Agent URL : http://agent.example.com:8090/agentapp Encryption Key : 6w2Tb03H0crtOcU2G5JmphiOoY6e42Pn Agent Profile name : WebLogicAgent Agent Profile Password file name : /tmp/wl10agentpw Agent Profile will be created right now by agent installer : true Agent Administrator : agentadmin Agent Administrator's password file name : /tmp/agentadminpw 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 (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/agents/weblogic10/j2ee_agents/weblogic_v10_agent /Agent_001/config/OpenSSOAgentBootstrap.properties Agent Configuration file location /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent /Agent_001/config/OpenSSOAgentConfiguration.properties Agent Audit directory location: /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent/Agent_001/install-logs/audit Agent Debug directory location: /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent/Agent_001/install-logs/debug Install log file location: /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent/install-logs/audit/custom.log Thank you for using Sun OpenSSO Enterprise Policy Agent 3.0.
After the installation finishes successfully, if you wish, check the installation log file in the following directory:
PolicyAgent-base/install-logs/audit
Restart the WebLogic Server/Portal 10 container.
After you install the WebLogic Server/Portal 10 agent for a specific domain, you cannot use that same agent on the same host for a different domain. To use the WebLogic Server/Portal 10 agent for another domain on the same host, you must install the agent specifically for that domain.
************************************************************************ Welcome to the Sun OpenSSO Enterprise Policy Agent 3.0 for BEA WebLogic 10.0 Platform. ************************************************************************ Enter the path to the location of the script used to start the WebLogic domain. Please ensure that the agent is first installed on the admin server instance before installing on any managed server instance. [ ? : Help, ! : Exit ] Enter the Startup script location [/usr/local/bea/user_projects/domains/base_domain/startWebLogic.sh]: /opt/bea/user_projects/domains/base_domain/startWebLogic.sh Enter the name of the WebLogic Server instance secured by the agent. [ ? : Help, < : Back, ! : Exit ] Enter the WebLogic Server instance name [AdminServer]: Enter the WebLogic home directory [ ? : Help, < : Back, ! : Exit ] Enter the WebLogic home directory [/usr/local/bea/wlserver_10.0]: /opt/bea/wlserver_10.0 Enter the URL where the OpenSSO Enterprise is running. Please include the deployment URI also as shown below: (http://opensso.sample.com:58080/opensso) [ ? : Help, < : Back, ! : Exit ] OpenSSO Enterprise URL: http://openssohost.example.com:58080/opensso Enter true if the agent is being installed on a Portal domain [ ? : Help, < : Back, ! : Exit ] Is the agent being installed on a Portal domain ? [false]: Enter the Agent URL. Please include the deployment URI also as shown below: (http://agent1.sample.com:1234/agentapp) [ ? : Help, < : Back, ! : Exit ] Agent URL: http://agent.example.com:8090/agentapp Enter a valid Encryption Key. [ ? : Help, < : Back, ! : Exit ] Enter the Encryption Key [6w2Tb03H0crtOcU2G5JmphiOoY6e42Pn]: Enter the Agent profile name [ ? : Help, < : Back, ! : Exit ] Enter the Agent Profile name: WebLogicAgent 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/wl10agentpw WARNING: Agent profile/User: WebLogicAgent does not exist in OpenSSO! Either "Hit the Back button, and re-enter the correct agent profile name/user name", or "Create this agent profile when asked (available only in custom-install)", or "Continue without validating it because agent profile is in sub realm", or "Continue without validating/creating it, and manually validate/create it in OpenSSO Enterprise after installation". Enter true if the Agent Profile is being created into OpenSSO by the installer. Enter false if it will be not be created by installer. [ ? : Help, < : Back, ! : Exit ] This Agent Profile does not exist in OpenSSO Enterprise, will it be created by the installer? (Agent Administrator's name and password are required) [true]: Agent Administrator is the Administrator user that can create, delete or update agent profile. [ ? : Help, < : Back, ! : Exit ] Enter the Agent Administrator's name: agentadmin Enter the path to a file that contains the password of Agent Administrator [ ? : Help, < : Back, ! : Exit ] Enter the path to the password file that contains the password of Agent Administrator: /tmp/agentadminpw ----------------------------------------------- SUMMARY OF YOUR RESPONSES ----------------------------------------------- Startup script location : /opt/bea/user_projects/domains/base_domain/startWebLogic.sh WebLogic Server instance name : AdminServer WebLogic home directory : /opt/bea/wlserver_10.0 OpenSSO Enterprise URL : http://openssohost.example.com:58080/opensso Agent Installed on Portal domain : false Agent URL : http://agent.example.com:8090/agentapp Encryption Key : 6w2Tb03H0crtOcU2G5JmphiOoY6e42Pn Agent Profile name : WebLogicAgent Agent Profile Password file name : /tmp/wl10agentpw Agent Profile will be created right now by agent installer : true Agent Profile type : J2EEAgent Agent Administrator : agentadmin Agent Administrator's password file name : /tmp/agentadminpw 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]: Copy amauthprovider.jar to /opt/bea/wlserver_10.0/server/lib/mbeantypes ...DONE. Creating directory layout and configuring Agent file for Agent_001 instance ...DONE. Reading data from file /tmp/wl10agentpw and encrypting it ...DONE. Generating audit log file name ...DONE. Creating tag swapped OpenSSOAgentBootstrap.properties file for instance Agent_001 ...DONE. Configure /opt/bea/user_projects/domains/base_domain/setAgentEnv_AdminServer.sh ...DONE. Configure /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent /config/OpenSSOAgentBootstrap.properties ...DONE. Creating the Agent Profile WebLogicAgent ...DONE. SUMMARY OF AGENT INSTALLATION ----------------------------- Agent instance name: Agent_001 Agent Bootstrap file location: /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent /Agent_001/config/OpenSSOAgentBootstrap.properties Agent Configuration file location /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent /Agent_001/config/OpenSSOAgentConfiguration.properties Agent Audit directory location: /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent/Agent_001/install-logs/audit Agent Debug directory location: /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent/Agent_001/install-logs/debug Install log file location: /opt/agents/weblogic10/j2ee_agents/weblogic_v10_agent/install-logs/audit/custom.log Thank you for using Sun OpenSSO Enterprise Policy Agent 3.0.