Sun OpenSSO Enterprise Policy Agent 3.0 User's Guide for Web Agents

Default Path and Directory Names

Policy Agent Software: Path and Directory Names

The Policy Agent software documentation uses the terms listed in the table that follows to represent default path and directory names.

Table P–5 Default Paths and Directory Names for Policy Agent Software

Term 

Description 

Agent-HomeDirectory

This place holder represents the directory you choose in which to unpack the Policy Agent binaries. 

PolicyAgent-base

This place holder represents the directory that holds all the agent-specific information. The path for this directory includes information that helps specify that particular agent. Therefore, the path information varies for each agent. While the following web agent directory is agent specific, it merely serves as an example: 


Agent-HomeDirectory/web_agents/sjsws_agent

If you are configuring an agent other than the one shown in the preceding example, PolicyAgent-base will represent a different path, but the general structure of the path will be the same.

AgentInstance-Dir

This place holder represents the directory that holds all the information that is specific to an agent installation. Therefore, the PolicyAgent-base directory holds all the information related to a specific agent. However, if you install that same agent more than once in the same location, each installation has information specific to that installation. That specific information is held in the AgentInstance-Dir directory. For example:

PolicyAgent-base/AgentInstance-Dir

where AgentInstance-Dir refers to an agent instance directory, which is usually similar to the following: Agent_001.

OpenSSO Enterprise Server: Path and Directory Names

The OpenSSO Enterprise server documentation uses the terms listed in the table that follows to represent default path and directory names.

Table P–6 Default Paths and Directory Names for OpenSSO Enterprise Server

Term 

Description 

zip-root

Represents the directory where the opensso.zip file is unzipped.

OpenSSO-Deploy-base

Represents the deployment directory where the web container deploys the opensso.war file.

This value varies depending on the web container. To determine the value of OpenSSO-Deploy-base, view the file name in the .openssocfg directory, which resides in the home directory of the user who deployed the opensso.war file. For example, consider this scenario with Application Server 9.1 as the web container:

  • Application Server 9.1 is installed in the default directory: /opt/SUNWappserver.

  • The opensso.war file is deployed by super user (root) on Application Server 9.1.

The .openssocfg directory is in the root home directory (/), and the file name in .openssocfg is:

AMConfig_opt_SUNWappserver_domains_domain1_applications_j2ee-modules_opensso_

Then, the value for OpenSSO-Deploy-base is:

/opt/SUNWappserver/domains/domain1/applications/j2ee-modules/opensso

ConfigurationDirectory

Represents the name of the configuration directory specified during the initial configuration of OpenSSO Enterprise server instance using the Configurator. 

The default is opensso in the home directory of the user running the Configurator. Thus, if the Configurator is run by root, ConfigurationDirectory is /opensso.