[Koha] Browse by hierarchy - Links not working

[Mark Tompsett]

Greetings,

DISCLAIMER: THIS FEEDBACK DOES NOT APPLY TO EVERYONE, PLEASE DON'T JUST TRY 
THIS BECAUSE YOU HAVE A PROBLEM.

> About your problem *Can't locate C4/Context.pm in @INC* Someone in this 
> forum found this solution:
> Copying C4 directory to /etc/perl/ should solve your problem:
> cp -a /usr/share/koha/lib/C4/  /etc/perl/

This is the WRONG solution. Yes, it works, but upgrading your koha in the 
future becomes a nightmare!

There are supposed to be two environment variables defined:
$KOHA_CONF
$PERL5LIB
If you do not have these defined, you will encounter problems running Koha 
scripts.

(WARNING! WARNING! WARNING! I AM NOT RESPONSIBLE IF YOU DO NOT READING 
CAREFULLY.)
*IF* (IF, IF, IF, IF, IF) PERL5LIB is not (I repeat NOT, NOT, NOT, NOT) 
defined at all, and given the results of your search:
(DO NOT DO THIS IF PERL5LIB IS DEFINED, BECAUSE YOU COULD BREAK SOMETHING 
ELSE!)
$ export PERL5LIB=/home/koha/kohaclone

Follow up questions:
If you have a kohaclone directory, how did you answer the build questions?
If you didn't build this, and it is a virtual machine image, ask the 
provider of that image.

One potential workaround, if your system is a koha only system:
Under Ubuntu, and perhaps other debian-based OSes (though I haven't tested 
them) you can add to the bottom of /etc/environment (as root):
PERL5LIB=/home/koha/kohaclone
Log out, and log back in, and this will be set for EVERY user on the system. 
This is only a good solution if the system is a koha only system. Otherwise, 
you will need to modify appropriate rc shell scripts in particular users 
home directories to set it.

GPML,
Mark Tompsett