PDF reporting installation

This is not needed since STOR2RRD v7.80+

If you are on Virtual Appliance 1.24+ then just use it, nothing is required, everything is already installed.
In any other case you would need to install a few Perl modules to make it work.
You will be prompted for its install when you click on the PDF report.

Install Perl module PDF::API2, use one of method below:

Linux (select one of following menthods)
  • YUM
    PDF modules (including dependencies) can be installed from EPEL repositories (fedoraproject.org/wiki/EPEL)
    # yum install epel-release
    # yum install perl-PDF-API2
    
    Note that epel-release might not be in your RedHat base repository especially for RHEL 6.x and olders.
    Install CentOS package instead epel-release-7-11.noarch.rpm.
    Follow this to get installed PDF support in the tool on RHEL 8 and CentOS 8.

  • Debian/Ubuntu:
    # apt-get install libpdf-api2-perl
    
AIX
  1. Download and install under root this package:
    www.oss4aix.org/download/RPMS/perl-Compress-Raw-Zlib/perl-Compress-Raw-Zlib-2.020-1.aix5.1.ppc.rpm
    # umask 022
    # rpm -Uvh perl-Compress-Raw-Zlib-2.020-1.aix5.1.ppc.rpm --nodeps
    
  2. Download and install dependency Perl modules PDF::API2 www.stor2rrd.com/download-static/lib-aix.tar.gz
    If your web browser gunzips it automatically then just rename it: mv lib-aix.tar.gz lib-aix.tar
    # su - stor2rrd  # (lpar2rrd user on the Virtual Appliance)
    $ umask 022
    $ cd /home/stor2rrd/stor2rrd
    $ gunzip lib-aix.tar.gz
    $ ls -l lib-aix.tar
      -rw-r--r--  stor2rrd users 21166080 Oct 21 13:26 lib-aix.tar
    $ tar xvf lib-aix.tar
    
  3. Use /opt/freeware/bin/perl in etc/stor2rrd.cfg
    It does not work with new Perl 5.20.x coming with new AIX versions!
    Assure you have installed it.
    In case you do not have it then install it togeher with the latest RRDTool : /opt/freeware/bin/perl installation
    $ ls -l /opt/freeware/bin/perl
      -rwxr-xr-x 2 root system 96131 Jan 14 2010  /opt/freeware/bin/perl
    $ vi etc/stor2rrd.cfg
      PERL=/opt/freeware/bin/perl
    
  4. Assure it is working
    # su - stor2rrd  # (lpar2rrd user on the Virtual Appliance)
    $ umask 022
    $ cd /home/stor2rrd/stor2rrd
    $ . etc/stor2rrd.cfg
    $ $PERL -e 'use IO::Compress::Zip; print "passed\n"'
      passed
    
    In case you get Perl error like below then update PERL5LIB in etc/stor2rrd.cfg to this:
    $ $PERL -e 'use IO::Compress::Zip; print "passed\n"'
     Can't load '/usr/opt/perl5/lib/5.10.1/aix-thread-multi//auto/B/B.so' for module B: rtld: 0712-001 Symbol Perl_croak_xs_usage was referenced
     ...
    $ vi etc/lpar2rd.cfg
      ...
      PERL5LIB=/home/stor2rrd/stor2rrd/bin:/usr/opt/perl5/lib/site_perl/5.8.8:/opt/freeware/lib/perl/5.8.0:/opt/freeware/lib/perl/5.8.8:/usr/opt/perl5/lib/site_perl/5.8.2:/usr/opt/perl5/lib/site_perl/5.8.8/aix-thread-multi:/opt/freeware/lib/perl5/vendor_perl/5.8.8/ppc-thread-multi:/usr/opt/perl5/lib/site_perl/5.10.1/aix-thread-multi:/home/stor2rrd/stor2rrd/lib
      ...
    $ $PERL -e 'use IO::Compress::Zip; print "passed\n"'
      passed
    
Solaris
    # /opt/csw/bin/pkgutil -y -i pm_iocompress
    # /opt/csw/bin/pkgutil -y -i zip
    # /opt/csw/bin/pkgutil -y -i pm_pdfapi2