User manual

Installing the Software Stack
Troubleshooting CPAN installations
If CPAN modules don't install successfully, we would see messages like these at the
end of install command:
MIRK /Net- Z3950- ZOOM- 1.26.tar.gz
:
writemakefile NO
' /usr /bin /perl Makefile.PL INSTALLDIRS =site' returned status 512
WRW /Barcode- Code128- 2.01.tar.gz
:
make_test NO
LARSLUND /PDF- Reuse -Barcode- 0.05.tar.gz
dependency not OK (Barcode::Code128)
cpan [8] >
:
make_test NO one
From the messages above, we learn that the module
Net -Z3950- ZOOM
has failed at
the
Make f i 1 e . PL
stage likely due to missing prerequisites.
The module
PDF -Reuse - Barcode
has failed to install, because one of its
prerequisites
- Barcode :: code 12 8
has failed at the make test stage.
To troubleshoot such problems we need to look at error messages for clues. Resolve
any problems that are found and then install each module manually using the make
set of commands.
As an example, let us troubleshoot problems with installing the module
Net -Z3950 -ZOOM.
We use the look command to get into a Linux subshell:
cpan[8]> look Net::Z3950::ZOOM
Running look for module 'Net::Z3950::ZOOM'
Trying to open a subshell in the build directory...
Working directory is / home /koha /.cpan /build /Net- Z3950- ZOOM -1.26- C9NuSo
We run make clean to start afresh:
sh -3.2# make clean
make:
* ** No rule to make target 'clean'.
Stop.
Next run the
Makef ile . PL
program:
sh -3.2# perl Makefile.PL
At this stage we see an error message indicating missing system packages:
ERROR: Unable to call script: yaz- config
If you are using a YAZ installation from the Debìan package "yaz ", you
will also need to install "libyaz -dev" in order to build this module.
[18]