Installing the Apache HTTP Server 2.0.x Agent Using the agentadmin Program

Before you install the Apache HTTP Server 2.0.x agent, your deployment must meet these requirements:

• An Apache HTTP Server 2.0.x instance must be installed and configured on the platform where you plan to install the agent.

• An OpenSSO Enterprise server instance must be installed and accessible to the Apache HTTP Server 2.0.x instance.

• You must have downloaded and unzipped the agent distribution file, as described in Downloading and Unzipping the Agent Distribution File.

To Install the Apache HTTP Server 2.0.x Agent Using the agentadmin Program

1. Login into 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 Apache HTTP Server instance.

2. Stop the Apache HTTP Server instance.

3. Change to the PolicyAgent-base/bin directory. For example:

   # cd /opt/web_agents/apache_agent/bin

4. Start the agent installation. For example:

   # ./agentadmin --custom-install

   On Windows systems, run the agentadmin.bat program.

5. 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
   -----------------------------------------------
   Apache Server Config Directory : /opt/apache-2.0.63/conf
   OpenSSO server URL : http://opensshost.example.com:8080/opensso
   Agent URL : http://agenthost.example.com:8090
   Agent Profile name : Apache2Agent
   Agent Profile Password file name : /tmp/apache2agentpw
   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]: 1

6. 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/apache_agent/Agent_001/config/OpenSSOAgentBootstrap.properties
   Agent Configuration Tag file location
   /opt/web_agents/apache_agent/Agent_001/config/OpenSSOAgentConfiguration.propertie
   s
   Agent Audit directory location:
   /opt/web_agents/apache_agent/Agent_001/logs/audit
   Agent Debug directory location:
   /opt/web_agents/apache_agent/Agent_001/logs/debug
   Install log file location:
   /opt/web_agents/apache_agent/installer-logs/audit/install.log

7. After the installation finishes successfully, if you wish, check the installation log file in the /installer-logs/audit directory

8. Restart the Apache HTTP Server instance for the agent.

Agent Installation Program Functions

The agent installation program performs these functions:

• Creates the OpenSSOAgentBootstrap.properties and OpenSSOAgentConfiguration.properties configuration files from the respective template files.

• Creates the file dsame.conf file from the template file.

• Modifies the httpd.conf file to include the path for the dsame.conf file.

• Creates the agent instance directory as PolicyAgent-base/Agent_nnn, where nnn identifies the agent instance as Agent_001, Agent_002, and so on for each additional agent instance.

  For example: /opt/web_agents/apache_agent/Agent_001

  Each agent instance directory contains the following subdirectories:

  • /config contains the configuration files for the agent instance, including OpenSSOAgentBootstrap.properties and OpenSSOAgentConfiguration.properties.

  • /logs contains the following subdirectories

    • /audit contains local audit trail for the agent instance.

    • /debug contains the debug files for the agent instance when the agent runs in debug mode.