IHS 9.0 Web Agent startup error

Products

• CA Single Sign On Agents (SiteMinder)
• SITEMINDER

Issue/Introduction

Web Agent 12.52 SP1 CR09 (64-bit) was installed and configured for IHS 9.0 Web server (which is based on Apache 2.4).
But, the startup failed due to the below error (output in console):

 

httpd: Syntax error on line 124 of /opt/IBM/HTTPServer/conf/httpd.conf:
 Cannot load /opt/CA/webagent/bin/libmod_sm20.so into server:
 /opt/CA/webagent/bin/libmod_sm20.so: undefined symbol: unixd_config

 

Referenced:
(1) docops: Start an IBM HTTP Server with the apachectl Command
(2) IBM document: Integration with CA SiteMinder

Environment

Web Agent 12.52 sp01 cr09 (64-bit)
OS: RHEL 7.5
Web Server: IBM HTTP Server 9.0.0.10 (Apache 2.4 base)

Resolution

First, customer reconfigured Web Agent to follow the below two documents.

 

(1) Before running the Wizard, set LD_LIBRARY_PATH properly.
Article Id: 44849 - Linux Web Agent configuration wizard unable to detect the IBM IHS(HTTP) server.

 

(2) After the configuration, to enable ca_wa_env.sh, update envvars and apachectl.
Article Id: 139748 - Webagent doesn't start after webserver patch

 

However, the problem still occurred.  Then, to resolve it, httpd.conf file was updated as following.

 

(i) Replaced libmod_sm20.so with libmod_sm24.so.

BEFORE:

LoadModule sm_module "/opt/CA/webagent/bin/libmod_sm20.so"
AFTER:  

LoadModule sm_module "/opt/CA/webagent/bin/libmod_sm24.so"

 

(ii) Replaced 'Order' and 'Allow' commands with 'Require' command.

 

BEFORE: 

Alias /siteminderagent/pwcgi/ "/opt/CA/webagent/pw/"
<Directory "/opt/CA/webagent/pw/">
Options Indexes MultiViews ExecCGI
AllowOverride None
Order allow,deny
Allow from all
</Directory>

Alias /siteminderagent/pw/ "/opt/CA/webagent/pw/"
<Directory "/opt/CA/webagent/pw/">
Options Indexes MultiViews ExecCGI
AllowOverride None
Order allow,deny
Allow from all
</Directory>

Alias /siteminderagent/ "/opt/CA/webagent/samples/"
<Directory "/opt/CA/webagent/samples/">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>

 

AFTER: 

Alias /siteminderagent/pwcgi/ "/opt/CA/webagent/pw/"
<Directory "/opt/CA/webagent/pw/">
Options Indexes MultiViews ExecCGI
AllowOverride None
Require all granted
</Directory>

Alias /siteminderagent/pw/ "/opt/CA/webagent/pw/"
<Directory "/opt/CA/webagent/pw/">
Options Indexes MultiViews ExecCGI
AllowOverride None
Require all granted
</Directory>

Alias /siteminderagent/ "/opt/CA/webagent/samples/"
<Directory "/opt/CA/webagent/samples/">
Options Indexes MultiViews
AllowOverride None
Require all granted
</Directory>

 

Finally, IHS Web Agent started up successfully.