AIX with yum

Document describes installation of LPAR2RRD server prerequisites on AIX where is yum available.

• Install Apache and RRDTool:
  

  yum install httpd rrdtool rrdtool-perl
  

  Do not use rrdtool-1.7.0-4, it has a bug, use older or newer RRDTool versions.
  
  
• Configure Apache:
  

  vi /opt/freeware/etc/httpd/conf/httpd.conf
  

  Enable CGI (it is hashed by default):

  <IfModule mpm_prefork_module>
          LoadModule cgi_module /opt/freeware/lib/httpd/modules/mod_cgi.so
  </IfModule>
  

  Place there LPAR2RRD cfg (it supposes that install home will be in /home/lpar2rrd/lpar2rrd):
  

  AddHandler cgi-script .sh
  
  #
  # LPAR2RRD
  #
  Alias /lpar2rrd  "/home/lpar2rrd/lpar2rrd/www/"
  <Directory "/home/lpar2rrd/lpar2rrd/www/">
      AllowOverride AuthConfig FileInfo
      Options Indexes FollowSymLinks
      Require all granted
  </Directory>
  # CGI-BIN
  ScriptAlias /lpar2rrd-cgi/ "/home/lpar2rrd/lpar2rrd/lpar2rrd-cgi/"
  <Directory "/home/lpar2rrd/lpar2rrd/lpar2rrd-cgi">
      AllowOverride AuthConfig FileInfo
      SetHandler cgi-script
      Options ExecCGI FollowSymLinks
      Require all granted
  </Directory>
  

  Apache restart:
  

  /opt/freeware/sbin/apachectl restart
  

• Create LPAR2RRD user under root:

  useradd -c "LPAR2RRD user" -m lpar2rrd
  chmod 755 /home/lpar2rrd
  chdev -l sys0 -a maxuproc=2000
  chuser  nofiles=32768 data=-1  stack=-1 rss=-1 lpar2rrd
  chuser  data=-1  stack=-1 rss=-1 apache
  

• Install LPAR2RRD server:

  # su - lpar2rrd
  tar xvf lpar2rrd-7.XX.tar
  cd lpar2rrd-7.XX
  ./install.sh
  

• You do not need to install modules like perl-XML etc, all necessary is already in perl.rte fileset, just this is needed:

  # rpm -qa| grep perl
    perl-5.30.3-1.ppc		
    rrdtool-perl-1.7.0-8.ppc
    perl-Crypt-SSLeay-0.57-2.ppc
    perl-DBD-Pg-3.7-4.ppc 		--> needed for XorMon only
    perl-DBD-SQLite-1.62-0.ppc 		--> needed for XorMon only
    net-snmp-perl-5.8-2.ppc		--> for SNMP Trap alerting only
  

• Make sure all Perl modules are in place
  

  cd /home/lpar2rrd/lpar2rrd
  . etc/lpar2rrd.cfg; $PERL bin/perl_modules_check.pl
  

  If any problem then adjust following variables in etc/lpar2rd.cfg
  Especially PERL must be set to /usr/bin/perl
  If it cannot find RRDp.pm then search it and place its path at the end of PERL5LIB

  # find /opt -name RRDp.pm 2>/dev/null
    /opt/freeware/lib/perl5/5.30/vendor_perl/RRDp.pm
    /opt/freeware/lib64/perl5/5.30/vendor_perl/RRDp.pm
  

  In case you use 32 bit rrdtool (happens when you migrate from older rrdtol version) then order is
  • 32bit: /opt/freeware/lib/perl5/5.30/vendor_perl:/opt/freeware/lib64/perl5/5.30/vendor_perl
  • 64bit: /opt/freeware/lib64/perl5/5.30/vendor_perl:/opt/freeware/lib/perl5/5.30/vendor_perl

  # file /opt/freeware/bin/rrdtool
    /opt/freeware/bin/rrdtool: 64-bit XCOFF executable or object module
  # file /opt/freeware/bin/rrdtool_32
    /opt/freeware/bin/rrdtool_32: executable (RISC System/6000) or object module
  

  This is how should look like some parameters in etc/lpar2rrd.cfg, adjust PERL5LIB if RRDp.pm is in different location

    PERL=/usr/bin/perl
    PERL5LIB=/home/lpar2rrd/lpar2rrd/bin:/home/lpar2rrd/lpar2rrd/vmware-lib:/home/lpar2rrd/lpar2rrd/lib:/opt/freeware/lib/perl5/5.30/vendor_perl:/opt/freeware/lib64/perl5/5.30/vendor_perl
    RRDTOOL=/opt/freeware/bin/rrdtool
  

• Enable web authorisation

  # su - lpar2rrd
  umask 022
  cd /home/lpar2rrd/lpar2rrd
  cp -p html/.htaccess www
  cp -p html/.htaccess lpar2rrd-cgi
  

• Go to Web UI, use admin/admin account, go to product configuration (settings icon), add HMCs, vCenters ...

  http://<your server IP/hostname>/lpar2rrd/
  

Upgrade from older Perzl RPM distribution (Apache 2.4.18-1, rrdtool 1.4.8 usualy) follow this