Installation


AIX

Procedure expects Apache 2.4.40+ installed via yum/dnf from Linux Tool box.
  • Install Apache if it is not already there
    yum install httpd
    
  • Enable CGI-BIN API (it is hashed by default) in /opt/freeware/etc/httpd/conf/httpd.conf
    <IfModule mpm_prefork_module>
            LoadModule cgi_module /opt/freeware/lib/httpd/modules/mod_cgi.so
    </IfModule>
    
  • Place there STOR2RRD cfg (it supposes that install home will be in /home/stor2rrd/stor2rrd)
    Append it to /opt/freeware/etc/httpd/conf/httpd.conf
    AddHandler cgi-script .cgi
    #
    # STOR2RRD
    #
    Alias /stor2rrd  "/home/stor2rrd/stor2rrd/www/"
    <Directory "/home/stor2rrd/stor2rrd/www/">
        AllowOverride AuthConfig FileInfo
        Options -Indexes
        Options FollowSymLinks
        AuthType basic
        AuthName "STOR2RRD authorization"
        Require valid-user
    </Directory>
    # CGI-BIN
    ScriptAlias /stor2rrd-cgi/ "/home/stor2rrd/stor2rrd/stor2rrd-cgi/"
    <Directory "/home/stor2rrd/stor2rrd/stor2rrd-cgi">
        AllowOverride AuthConfig FileInfo
        SetHandler cgi-script
        Options ExecCGI FollowSymLinks
        AuthName "STOR2RRD authorization"
        AuthType basic
        Require valid-user
    </Directory>
    
    KeepAlive On
    KeepAliveTimeout 5
    TimeOut 1200
    
  • Apache restart
    /opt/freeware/sbin/apachectl restart
    
  • Make sure apache starts after the OS boot

  • Enable authorization in STOR2RRD after its installation (i.e. next tab, now such directories do not exist)
    # su - stor2rrd
    umask 022
    cd /home/stor2rrd/stor2rrd
    cp html/.htaccess www
    cp html/.htaccess stor2rrd-cgi
    
  • Test web pages
    Point your web browser to http://<your stor2rrd host>/stor2rrd/ as soon as you configure STOR2RRD


Red Hat, CentOS, Rocky Linux ...

  • Install Apache if it is not already there
    yum install httpd
    
  • Append at the end of /etc/httpd/conf/httpd.conf following
    Alias /stor2rrd  "/home/stor2rrd/stor2rrd/www"
    #
    # STOR2RRD
    #
    <Directory "/home/stor2rrd/stor2rrd/www/">
        AllowOverride AuthConfig FileInfo
        Options -Indexes
        Options FollowSymLinks
        AuthType basic
        AuthName "STOR2RRD authorization"
        Require valid-user
    </Directory>
    
    # CGI-BIN
    ScriptAlias /stor2rrd-cgi/ "/home/stor2rrd/stor2rrd/stor2rrd-cgi/"
    <Directory "/home/stor2rrd/stor2rrd/stor2rrd-cgi">
        AllowOverride AuthConfig FileInfo
        SetHandler cgi-script
        Options ExecCGI FollowSymLinks
        AuthType basic
        AuthName "STOR2RRD authorization"
        Require valid-user
    </Directory>
    
    KeepAlive On
    KeepAliveTimeout 5
    TimeOut 1200
    
  • Edit /etc/httpd/conf.modules.d/00-mpm.conf, enable mpm_prefork_module, diasble mpm_event_module
    LoadModule mpm_prefork_module modules/mod_mpm_prefork.so
    #LoadModule mpm_event_module modules/mod_mpm_event.so
    
  • Apache restart under root
    apachectl restart
    
  • Make sure apache starts after the OS boot
    systemctl enable httpd.service
    
  • Enable authorization in STOR2RRD after its installation
    # su - stor2rrd
    umask 022
    cd /home/stor2rrd/stor2rrd
    cp html/.htaccess www
    cp html/.htaccess stor2rrd-cgi
    
  • Test web pages
    Point your web browser to http://<your stor2rrd host>/stor2rrd/ as soon as you configure STOR2RRD

  • If you have firewall enabled then enable STOR2RRD communication by:
    firewall-cmd --add-service=http --permanent
    firewall-cmd --add-service=https --permanent
    firewall-cmd --add-port=8162/tcp --permanent
    
    firewall-cmd --reload
    
  • You might need to disable SElinux
    You must do it in case you get either "(13)Permission denied:" or "AH00132: file permissions deny server access" in Apache error_log.
    You have 2 options:
    • Disable SELinux only for Apache
      Step 1. Query for the Boolean value you need to change:
      # getsebool -a | grep httpd_dis
        httpd_disable_trans --> off
      
      Step 2. Disable the SELinux protection:
      # setsebool -P httpd_disable_trans=1
      
      Step 3. Verify that the Boolean has changed:
      # getsebool -a | grep httpd_dis
        httpd_disable_trans --> on
      
    • Globally disable SELinux
      # setenforce Permissive
      # vi /etc/sysconfig/selinux
        SELINUX=disabled
      
    Follow SELinux configuration in case you want to enable SELinux only for STOR2RRD

Debian, Ubuntu ...

  • Install Apache if it is nit already there
    # apt-get install httpd
    
  • Enable CGI-BIN and optionally even SSL if it is required
    # a2enmod cgi
    # a2enmod ssl
    
  • Append this at the end of /etc/apache2/apache2.conf
    AddHandler cgi-script .sh
    #
    # STOR2RRD
    #
    Alias /stor2rrd  "/home/stor2rrd/stor2rrd/www/"
    <Directory "/home/stor2rrd/stor2rrd/www/">
        AllowOverride AuthConfig FileInfo
        Options -Indexes
        Options FollowSymLinks
        AuthType basic
        AuthName "STOR2RRD authorization"
        Require valid-user
    </Directory>
    # CGI-BIN
    ScriptAlias /stor2rrd-cgi/ "/home/stor2rrd/stor2rrd/stor2rrd-cgi/"
    <Directory "/home/stor2rrd/stor2rrd/stor2rrd-cgi">
        AllowOverride AuthConfig FileInfo
        SetHandler cgi-script
        Options ExecCGI FollowSymLinks
        AuthType basic
        AuthName "STOR2RRD authorization"
        Require valid-user
    </Directory>
    
    KeepAlive On
    KeepAliveTimeout 5
    TimeOut 1200
    
  • Apache restart
    apachectl restart
    
  • Make sure apache starts after the OS boot
    systemctl start apache2.service
    
  • Enable authorization in STOR2RRD after its installation
    # su - stor2rrd
    umask 022
    cd /home/stor2rrd/stor2rrd
    cp html/.htaccess www
    cp html/.htaccess stor2rrd-cgi
    
  • Test web pages
    Point your web browser to http://<your stor2rrd host>/stor2rrd/ as soon as you configure STOR2RRD

  • If you have firewall enabled then enable STOR2RRD communication by:
    firewall-cmd --add-service=http --permanent
    firewall-cmd --add-service=https --permanent
    firewall-cmd --add-port=8162/tcp --permanent
    
    firewall-cmd --reload
    
  • You might need to disable SElinux
    You must do it in case you get either "(13)Permission denied:" or "AH00132: file permissions deny server access" in Apache error_log.
    You have 2 options:
    • Disable SELinux only for Apache
      Step 1. Query for the Boolean value you need to change:
      # getsebool -a | grep httpd_dis
        httpd_disable_trans --> off
      
      Step 2. Disable the SELinux protection:
      # setsebool -P httpd_disable_trans=1
      
      Step 3. Verify that the Boolean has changed:
      # getsebool -a | grep httpd_dis
        httpd_disable_trans --> on
      
    • Globally disable SELinux
      # setenforce Permissive
      # vi /etc/sysconfig/selinux
        SELINUX=disabled
      
    Follow SELinux configuration in case you want to enable SELinux only for STOR2RRD

SuSE

  • Append at the end of /etc/apache2/httpd.conf following
    AddHandler cgi-script .sh
    #
    # STOR2RRD
    #
    Alias /stor2rrd  "/home/stor2rrd/stor2rrd/www/"
    <Directory "/home/stor2rrd/stor2rrd/www/">
        AllowOverride AuthConfig FileInfo
        Options -Indexes
        Options FollowSymLinks
        AuthType basic
        AuthName "STOR2RRD authorization"
        Require valid-user
    </Directory>
    # CGI-BIN
    ScriptAlias /stor2rrd-cgi/ "/home/stor2rrd/stor2rrd/stor2rrd-cgi/"
    <Directory "/home/stor2rrd/stor2rrd/stor2rrd-cgi">
        AllowOverride AuthConfig FileInfo
        SetHandler cgi-script
        Options ExecCGI FollowSymLinks
        AuthType basic
        AuthName "STOR2RRD authorization"
        Require valid-user
    </Directory>
    
    KeepAlive On
    KeepAliveTimeout 5
    TimeOut 1200
    
  • Make sure apache starts after the OS boot

  • Enable authorization in STOR2RRD after its installation
    # su - stor2rrd
    umask 022
    cd /home/stor2rrd/stor2rrd
    cp html/.htaccess www
    cp html/.htaccess stor2rrd-cgi
    
  • Test web pages
    Point your web browser to http://<your stor2rrd host>/stor2rrd/ as soon as you configure STOR2RRD


  • If you have firewall enabled then enable STOR2RRD communication by:
    firewall-cmd --add-service=http --permanent
    firewall-cmd --add-service=https --permanent
    firewall-cmd --add-port=8162/tcp --permanent
    
    firewall-cmd --reload
    

Troubleshooting

Apache error_log

When STOR2RRD application is not reachable via the web server, check Apache error log for new errors under root user
  • AIX
    cd /opt/freeware/etc/httpd/logs
    tail error_log
    
  • Linux:
    cd /etc/httpd/logs/
    tail error_log
    
  • "(13)Permission denied:" or "AH00132: file permissions deny server access"
    Solution:
    Problem either with SELinux (check above per OS settings) or Apache user does not have read access to STOR2RRD web /home/stor2rrd/stor2rrd/www
    Make sure that all subdirectories in the path are readable for apache user (ps -ef| egrep "httpd|apache")

  • AH01257: unable to connect to cgi daemon after multiple tries
    AH01630: client denied by server configuration
    Solution:
    Enable mpm_prefork_module and disable mpm_event_module in /etc/httpd/conf.modules.d/00-mpm.conf
    LoadModule mpm_prefork_module modules/mod_mpm_prefork.so
    #LoadModule mpm_event_module modules/mod_mpm_event.so
    
  • AH01220: Timeout waiting for output from CGI script
    Solution:
    Apache default timeout is 1 minute what might not be enhough for longer reports, increase it by adding this at the end of httpd.conf
    KeepAlive On
    KeepAliveTimeout 5
    TimeOut 1200
    

Apache access_log (ssl_error_log)

Check also access_log or ssl_error_log if there are new entries when you try to reach the web via the browser, if do not then either:
  • Apache is not running, no any process is listed
    ps -ef| egrep "httpd|apache"| grep -v grep
    
  • Firewall on the STOR2RRD host blocking it, disable it
    firewall-cmd --add-service=http --permanent
    firewall-cmd --add-service=https --permanent
    firewall-cmd --add-port=8162/tcp --permanent
    
    firewall-cmd --reload
    
  • Company's network/firewall blocking it, check with your security team