Apache failing to start after agent configuration

book

Article ID: 195700

calendar_today

Updated On:

Products

CA Single Sign On Secure Proxy Server (SiteMinder) CA Single Sign On Agents (SiteMinder) SITEMINDER

Issue/Introduction

Following a successful siteminder web agent configuration, the Apache instance fails with the following error.

Received ERROR during the apache - restart for line 29 i.e. CAPKI path variable defination.
AH00526: Syntax error on line 27 of /etc/apache2/conf/httpd.conf:
Invalid command 'PassEnv', perhaps misspelled or defined by a module not included in the server configuration

Line 27 in the HTTPD.conf file is the following:

PassEnv CAPKIHOME

Cause

The Agent Configuration Wizard populates the following in the HTTPD.conf file

PassEnv CAPKIHOME

CAPKIHOME is an environment variable set in the 'ca_wa_env.sh' environment variable script which is typically invoked by the 'apachectl' script during the Apache startup and passed to the HTTPD.conf file.

The Embedded version of Apache used by the third party application does not include the 'mod_env.so' module.   The 'PassEnv' directive comes from the 'mod_env.so' module.  The PassEnv directive cannot be invoked because it is not recognized by the Apache Instance

Environment

Release : 12.52

Component : SITEMINDER -WEB AGENT FOR APACHE

Resolution

An ASF Apache version that matches the one installed by the 3rd party application had to be downloaded and configured.  The 'mod_env'so' module had to be copied from the stand-alone Apache instance and placed into the /modules directory in the embedded 3rd party Apache instance.  This resolved the issue and allowed the CAPKIHOME environment variable to be passed in the httpd.conf and the Apache instance to start correctly.