NAME

   PDF::PDFUnit::Installation - Installation instructions for PDF::PDFUnit

IMPORTANT

   This Module is not useable on its own!

   It it "just" a Perl wrapper around Carsten Siedentop's awesome PDFUnit
   <http://pdfunit.com/> (a PDF testing framework written in Java).

INSTALLATION OF PERL PREREQUISITES

   The most tricky part is the installation of our main dependency:
   Inline::Java.

   This is typically not pre-packaged in any distribution of Linux or
   Perl, so we have to install it by hand.

   We generally recommend installing it via cpanm, as described below.

   Some other dependencies should be fulfilled with distribution packages
   before:

Linux

 Debian 8 (Jessie)

     # aptitude install openjdk-7-jdk make gcc
     # aptitude install cpanminus libinline-c-perl libtest-exception-perl

     # JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64  cpanm Inline::Java

 Ubuntu 14.04

     $ sudo su -
     # apt-get install openjdk-7-jdk make gcc
     # apt-get install cpanminus libinline-perl libtest-exception-perl

     # JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64  cpanm Inline::Java

 CentOS 7

     # yum install java-1.8.0-openjdk-devel make gcc
     # yum install perl-App-cpanminus perl-Inline perl-Test-Exception

     # JAVA_HOME=/usr/lib/jvm/java-1.8.0  cpanm Inline::Java

 OpenSUSE 42.1

     # zypper install java-1_8_0-openjdk-devel make gcc
     # zypper install perl-App-cpanminus perl-Inline perl-Test-Exception

     # cpanp install Parse::PMFile  # due to broken cpanm; "yes" to question

     # JAVA_HOME=/usr/lib64/jvm/java-1.8.0-openjdk-1.8.0  cpanm Inline::Java

Windows

 Windows 8.1 with Oracle JDK + ActiveState Perl 5.22.1 (both 64 Bit)

     C:\> ppm install App-cpanminus MinGW
     C:\> ppm install Inline Test-Exception

     C:\> set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_92
     C:\> cpanm Inline::Java

INSTALLATION OF THE JAVA PDFUNIT LIBRARY

   Download the latest release of PDFUnit-Java from http://pdfunit.com/.

   Create a folder somewhere and unzip it there.

   If you have received a licence file, also drop it there.

INSTALLATION OF THIS MODULE

   Attention! Under Windows/ActivePerl, use dmake instead of make!

     perl Makefile.PL
     make

   If you want to run the tests, you have to create a configuration file.
   OK, since you have to create a config anyway, now would be a good time
   to read PDF::PDFUnit::Config; if necessary via:

     # Linux:
     perldoc lib/PDF/PDFUnit/Config.pod

     # Windows:
     perldoc lib\PDF\PDFUnit\Config.pod

   With your new config file, you should now be able to:

     make test

     # or (to get a little bit more output):

     prove -v

   And finally (this requires root/Admin permissions where necessary):

     make install

   If everything has succeeded up to now, please verify your setup with:

     pdfunit-perl.pl -c

   Have fun with PDF::PDFUnit!