HTTPD server – what is configured?

This is one of a series of blog posts on HTTPD.

• Getting started with HTTPD server on z/OS
• Extending HTTPD server on z/OS
• Configuring the config file
• Getting HTTPD server to work with TLS on z/OS

You can run an Apache command, or display in the web browser, the active configuration with variables substituted, and If statements processed.

The server can dump configuration at startup. The best option was

-t -DDUMP_CONFIG

which displays the configuration with symbols substituted and after If processing. You can use this as part of your startup, or standalone, or as a web page. The web page displays more information.

/usr/lpp/ihs*/bin/apachectl -f /u/mqweb3/conf/httpd.conf -t -DDUMP_CONFIG > aa

This displays lots of good information. Below is an illustrative subset of what is available

• Server settings
  • Server build:Jun 10 2020 16:22:51
  • Host Name/port:10.1.1.2:8831
  • Server Root: /u/mqweb3
• Information about each module, for example ‘Module Name:mod_rewrite.c‘
  • Module directives, a list of all the actions supported eg
    • ‘RewriteRule – an URL-applied regexp-pattern and a substitution URL ‘
  • Current configuration for that module, with If statements processed, and variables substituted
    • In file: /u/mqweb3/conf/80.conf
    • 23: <VirtualHost *:1444>  
    • 26:   RewriteEngine On  
    • 35:   RewriteEngine On  
    • 37:   RewriteRule ^/(PKIServ|Customers)/ssl-cgi/(.*) https://10.1.1.2/$1/ssl-cgi-bin/$2 [R,NE]  
    • 38:   RewriteRule ^/(PKIServ|Customers)/clientauth-cgi/(.*) https://10.1.1.2:1443/$1/clientauth-cgi-bin/$2 [R,NE]  
    • 40:   RewriteRule ^/(PKIServ|Customers)/EU(.*) https://10.1.1.2/$1/ssl-cgi-bin/camain.rexx    : </VirtualHost>
• Information about each module, for example ‘Module Name:mod_ibm_ssl.c‘
  • Module directives, a list of all the actions supported eg
    • ‘SSLEnable – SSL is enabled for this server‘
  • Current configuration for that module, with If statements processed, and variables substituted. Line 10 was ‘Keyfile /saf ${pkiRing}’
    • In file: /u/mqweb3/conf/pkissl.conf   
    • 1:   SSLEnable  
    • 10:   Keyfile /saf START1/MQRING
    • etc

To run it as a web page, the configuration is below.

LoadModule info_module modules/mod_info.so
<Location /server-info>
SetHandler server-info
AuthType Basic
AuthBasicProvider saf
SAFRunAs PKISERV
</Location>

and the URL was

http://10.1.1.2:8831/server-info