How to modify the settings on the CA eHealth Server when setting up a CA eHealth - CA SiteMinder environment

Document ID : KB000039408
Last Modified Date : 14/02/2018
Show Technical Document Details


If you want to your CA eHealth environment to include CA SiteMinder for web users authentication, you need to set up your CA SiteMinder-CA eHealth environment.



Before you modify the settings on the CA eHealth Server, verify that you have met the following prerequisites:

1>Have set up the CA SiteMinder Server

2>Have set up the CA eHealth Server

3>Have installed CA SiteMinder Web Agent Software on the CA eHealth Server

The SiteMinder 12.52 SP1 CR1 is the only supported version in EH 



Fix #RS78580 

File name: 




CA eHealth

SiteMinder 12.52.SP1 CR1(32-bit)



After installed CA SiteMinder Web Agent, you need to use the following procedure to modify the settings on the CA eHealth server manually.

NOTE: for Solaris use Unix style paths and environment variables dereferencing, e.g. $NH_HOME, /opt/CA/webagent, etc.


Follow these steps:

1>Copy a sample file <WebAgent>/config/WebAgent.conf.sample to %NH_HOME%/web/httpd/conf/WebAgent.conf.

Note: This step is required because it is a workaround for an undetected Apache issue.

2>Edit the %NH_HOME%/web/httpd/conf/httpd.conf file.

  a. Open the file and search for DocumentRoot.

  b. Immediately after that line, copy the following two lines:


LoadModule sm_module "<path to valid Apache SiteMinder module .dll/.so>"

SmInitFile "<path to WebAgent.conf>"



Example for Windows:

DocumentRoot  "c:/ehealth632/web/output"

LoadModule sm_module "C:/Program Files/CA/webagent/bin/mod_sm24.dll"

SmInitFile "C:/eHealth632/web/httpd/conf/WebAgent.conf"


3>Edit the file %NH_HOME%/web/httpd/conf/WebAgent.conf as follows:

  a. Supply the value of HostConfigFile. For example, C:\Program Files\CA\webagent\config\SmHost.conf.

  b. Supply the value of AgentConfigObject created for your eHealth system.

  c. Set EnableWebAgent to Yes.


Example for Windows: 


HostConfigFile="C:\Program Files\CA\webagent\win32\config\SmHost.conf"




LoadPlugin="C:\Program Files\CA\webagent\win32\bin\HTTPPlugin.dll"


Additional Information:

For information about configuring CA eHealth and CA Spectrum to use CA SSO with CA SiteMinder, contact CA Services.