Previous Topic: Agent Configuration MethodsNext Topic: Basic Agent Setup and Policy Server Connections


Configuration Files used by the Web Agent

CA SiteMinder® Web Agents use configuration files for certain settings. Some of these configuration files are installed on the web server with the Web Agent. Other configuration files are created the web server by the CA SiteMinder® Web Agent Configuration Wizard where the Web Agent files are associated with the particular web server product installed on the computer hosting your web server.

For example, if you install a Web Agent on a 32-bit Windows system that runs an Apache Web Server, the Web Agent Configuration Wizard makes the changes in your Apache Web Server configuration required by the CA SiteMinder® Web Agent..

Agent Connection Manager Configuration File

The Web Agent installation wizard installs the Agent Connection Manager Configuration file (AgentConMgr.conf), in the following location:

web_agent_home/config

web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default (Windows 32-bit installations of CA SiteMinder® Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [CA SiteMinder® Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA SiteMinder® Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

The Agent Connection Manager Configuration file lets you create detailed trace logs about the connections the Web Agent makes while operating.

More information:

Collect Detailed Agent Connection Data with an Agent Connection Manager Trace Log

Connection API Configuration File

The Connection API file (conapi.conf) is used to configure services through the Connection API. These services include the OneView Monitor.

The Web Agent Installation wizard creates the Connection API Configuration file in the following location:

web_agent_home/config
web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default (Windows 32-bit installations of CA SiteMinder® Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [CA SiteMinder® Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA SiteMinder® Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

Note: More information about using the OneView Monitor exists in the Policy Server Administration Guide.

Local Agent Configuration File

The Web Agent Installation wizard installs a Local Agent Configuration File (LocalConfig.conf) in the following location:

web_agent_home/config

web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default (Windows 32-bit installations of CA SiteMinder® Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [CA SiteMinder® Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA SiteMinder® Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

This file lets you set the Web Agent configuration parameters on the same web server where the Web Agent is installed, instead of using the parameter settings stored in the Agent Configuration Object on the associated Policy Server.

For IIS Web Agents, the Web Agent Configuration Wizard makes a duplicate copy of the Local Agent Configuration file in the following location:

web_agent_home\bin\IIS

More information:

Local Agent Configuration

LocalConfig.conf File Locations (Framework Agents)

Trace Configuration File

The Trace Configuration File (trace.conf) lets you configure trace logs for the following items:

The Web Agent Installation Wizard creates the Trace Configuration file in the following location:

web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default (Windows 32-bit installations of CA SiteMinder® Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [CA SiteMinder® Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA SiteMinder® Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

More information:

Restrict IPC Semaphore-Related Message Output to the Apache Error Log

Web Agent Trace Configuration File

The Web Agent Trace Configuration file lets you create trace logs for various aspects of the Web Agent operations. For example, you can create a trace log of any Web Agent operations related to the CA SiteMinder® single-sign on (SSO) feature.

The Web Agent Installation wizard creates the Web Agent Trace Configuration file in the following location:

web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default (Windows 32-bit installations of CA SiteMinder® Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [CA SiteMinder® Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA SiteMinder® Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

More information:

How to Set Up Trace Logging

CA SiteMinder® Host Configuration File

The Web Agent Configuration wizard creates a Host Configuration File (SmHost.conf) on every web server on which you configure a CA SiteMinder® Web Agent in the following location:

web_agent_home/config

web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default (Windows 32-bit installations of CA SiteMinder® Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [CA SiteMinder® Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA SiteMinder® Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

The SmHost.conf file contains information that the Web Agent uses to make initial connections to the Policy Servers to which it is associated.

More information:

Connect a Web Agent to a Dynamic Policy Server Cluster

Web Agent Configuration File

The CA SiteMinder® Web Agent Configuration Wizard creates a Web Agent Configuration file (WebAgent.conf) on every web server on which you configure a CA SiteMinder® Web Agent in the following location:

web_agent_home\conf

web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default (Windows 32-bit installations of CA SiteMinder® Web Agents only): C:\Program Files\CA\webagent

Default (Windows 64-bit installations [CA SiteMinder® Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with CA SiteMinder® Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

Default (UNIX/Linux installations): /opt/ca/webagent

This file is used to enable or disable (start or stop) the Web Agent.

For IIS Web Agents, the Web Agent Configuration Wizard makes a duplicate copy of the Local Agent Configuration file in the following location:

web_agent_home\bin\IIS

More information:

Enable a Web Agent

Disable a Web Agent