IJ09207: SSMV401 : DOCS: APACHE 2.4 REQUIRES ADDITIONAL CONFIGURATION TO BE MONITORED ON RED HAT LINUX BY THE SSMAGENT

IBM Netcool System Service Monitor SSM 4.0 Interim Fix 04 README 4.0.1.3-TIV-SSM-IF0004

APAR status

• Closed as documentation error.

Error description

• Apache 2.4 is configured slighly differently than earlier
  versions and this prevents the documented method of enabling the
  server-status URL from working.
  
  Additionally Red Hat linux does not allow the SSM Agent to read
  the httpd.pid file when the soft link is a root[/] soft link
  rather than a relative soft link.
  

Local fix

• STEP #1
  
  Enabing Apache 2.4 server-status
  
  Check the server status module is available:
  
  /usr/sbin/httpd -M | grep status
  status_module (shared)
  
  Create the status.conf file:
  
  /etc/httpd/conf.modules.d/status.conf
  
  <IfModule mod_status.c>
      <Location /server-status>
          SetHandler server-status
          <RequireAny>
              Require local
              Require ip 127.0.0.1
          </RequireAny>
      </Location>
      ExtendedStatus On
  </IfModule>
  
  Make sure that the PidFile is entered in the httpd.conf file.
  e.g.
  cd /etc/httpd/conf
  grep PidFile  httpd.conf
  PidFile run/httpd.conf
  
  To stop Apache kill the root httpd process:
  cat /etc/httpd/run/httpd.pid
  ######
  
  ps -ef | grep ######
  <list of httpd pids>
  
  kill -15 ######
  
  ps -ef | grep ######
  <nothing>
  
  To start Apache run:
  /usr/sbin/httpd
  
  
  curl http://127.0.0.1/server-status?auto
  
  Resulting status query results
  
  
  
  
  STEP #2
  
  The Apache server installation uses root[/] paths for the run
  directory which is a problem in newer red hat releases. This
  prevents the SSM Agent from reading the PID file of for the
  Apache server.
  
  To make the run directory relative, perform the following task:
  
      Stop Apache
  
  ps -ef |grep httpd | grep root | grep -v grep
  root     <PID> .... /usr/sbin/httpd
  kill -15 <PID>
  ps -ef |grep httpd | grep root | grep -v grep
  <nothing returned>
  
      Now create a new link for run:
  
  cd /etc/httpd
  mv run run.orig
  ln -s ../../var/run/httpd run
  
  Start Apache
  /usr/sbin/httpd
  
      Restart the ssm agent
  
  /opt/netcool/ssm/bin/init.ssmagent stop
  /opt/netcool/ssm/bin/init.ssmagent start
  /opt/netcool/ssm/bin/init.ssmagent status
  
  Check for the Apache PID
  
  To roll back:
  Stop Apache
  mv run run.apache22
  mv run.orig run
  Start Apache
  

Problem summary

• Apache 2.4 is configured slighly differently than earlier
  versions and this prevents the documented method of enabling the
  server-status URL from working.
  
  Additionally Red Hat linux does not allow the SSM Agent to read
  the httpd.pid file when the soft link is a root[/] soft link
  rather than a relative soft link.
  

Problem conclusion

• Add documentation to the interim fix README
  
  The fix for this APAR is documented in the following
  maintenance vehicle:
  
  | interim fix | 4.0.1.3-TIV-SSM-IF0004  |
  
  Note: The fix is available at:
  https://www.ibm.com/support/pages/node/6047374
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels