NAME 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 (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!