This section provides task descriptions for the configuration of the agent for multiple instances of Sun Java System Web Proxy Server 4.0 and the configuration of SSL with the agent. Perform these tasks if they apply to your site's deployment.
Only perform a task if a respective condition applies.
To configure Agent for Sun Java System Web Proxy Server 4.0 for multiple proxy server instances on a single computer, use the GUI or command-line version of the agent installation program to install the first agent. After the first agent is installed, you can then configure the agent for multiple instances of Sun Java System Web Proxy Server 4.0 using the config script that is copied into the system during the agent installation. This script must be run in the command line as described in the next section. The config script and the unconfig script are both located in the following directory:
To configure the agent for additional Sun Java System Web Proxy Server 4.0 instances on a system, run the config script in the bin directory using the following command:
Follow the prompts to install additional instances of Agent for Sun Java System Web Proxy Server 4.0.
For information on each of the prompts, see Command-Line Installation of Agent for Sun Java System Web Proxy Server 4.0 on Solaris Systems.
In general, information needs to be entered for both the protected Sun Java System Web Proxy Server 4.0 instance and the instances of Access Manager. The following text serves as an example.
# ./config Enter the Proxy Server Instance Directory:  Enter the Local Hostname:  Enter the Agent Web Server Port:  Select Agent Web Server Protocol:  http  https -->  Enter the Agent Deployment URI [/amagent] Enter the Access Manager Hostname:  Enter the Access Manager Port:  Select Access Manager Protocol:  http  https -->  Enter the Access Manager Deployment URI [/amserver] Enter the Access Manager's Console Deployment URI [/amconsole] Do You Want Failover Server Support:  yes  No -->  Enter the User Name [UrlAccessAgent] Enter Agent-Access Manager shared secret: Re-enter Agent-Access Manager shared secret: Is CDSSO Enabled:  yes  no -->  Configuring proxy server ... Server version: 4.0
Be sure to use the unconfig script to uninstall any web agent that was installed using the config script. You cannot use the GUI installation program to uninstall web agents that were installed using the command line. The GUI uninstallation program must be executed only after unconfiguring all the existing web agents using the command-line unconfig script.
During installation, if you choose the HTTPS protocol, Agent for Sun Java System Web Proxy Server 4.0 is automatically configured and ready to communicate over Secure Sockets Layer (SSL). Before proceeding with tasks in this section, ensure that the Sun Java System Web Proxy Server 4.0 instance is configured for SSL.
You should have a solid understanding of SSL concepts and the security certificates required to enable communication over the HTTPS protocol. See the documentation for Sun Java System Web Proxy Server 4.0.
Add the Sun Java System Web Proxy Server 4.0 certificate’s root CA certificate to the Access Manager’s certificate database.
Mark the CA root certificate as trusted to enable Access Manager to successfully send notifications to Agent for Sun Java System Web Proxy Server 4.0.
This section only applies when Access Manager itself is running SSL. By default, the agent installed on a remote Sun Java System Web Proxy Server 4.0 instance trusts any server certificate presented over SSL by the Access Manager host. The agent does not check the root Certificate Authority (CA) certificate. If the Access Manager host is SSL-enabled and you want the agent to perform certificate checking, adhere to the guidelines as described in the following subsections:
The following property in the web agent AMAgent.properties configuration file controls the agent’s trust behavior, and by default it is set to true:
With this property set to true, the agent does not perform certificate checking. On Solaris systems, setting this property to false is one of the steps involved in enabling the web agent to perform certificate checking as illustrated in the following task.
Set the following property in the web agent AMAgent.properties configuration file to false as follows:
com.sun.am.trust_server_certs = false
Set the directory Cert DB in the web agent AMAgent.properties configuration file as shown in the following example:
com.sun.am.sslcert.dir = /opt/SUNWam/servers/alias
Set the Cert DB Prefix, if required.
In cases where the specified Cert DB directory has multiple certificate databases, the following property must be set to the prefix of the certificate database to be used:
Set the property as follows:
com.sun.am.certdb.prefix = https-host.domain.com.host-
The root CA certificate that you install on the remote instance of Sun Java System Web Proxy Server 4.0 must be the same one that is installed on the Access Manager host.
For instructions on installing a root CA certificate, see the documentation for Sun Java System Web Proxy Server 4.0. For example, see Sun Java System Web Proxy Server 4.0.2 2005Q4 Administration Guide.