Varnish Cache Plus

Relocation

Package Relocation (Enterprise Linux)

Description

Varnish Cache Plus supports relocated installation. This means that the software can be installed to a separate non-system-wide location, for example /opt/varnish/.

Normal use of this is to comply with local (security) policies. This functionality should be used sparingly, as it brings with extra complications when it comes to installation and setup of the software.

Installation

Installing relocated must be done using the RPM tool directly, as the normal package manager yum does not support it.

A script for doing semi-automatic modifications of changed paths in installed scripts/config files is added. Run this as described after the package installation is done.

Installation steps:

yum install yum-utils
yum downloader varnish-plus varnish-plus-libs varnish-plus-libs-devel

Install packages that Varnish Plus depends on:

$ rpm -Uvh --relocate /=/opt/varnish varnish-plus*.rpm
$ /usr/share/doc/varnish-plus-*/relocate /opt/varnish

To install the packages Varnish depends on it is easiest to install it non-relocated using yum first, and then uninstall it. This allows the automatic dependency solver in yum to do the work for you.

All files should now be installed to /opt/varnish/. The relocate script will try to create system-wide symlinks for some necessary paths. PATH, LDPATH and MANPATH defaults will be appended to.

After this it should be possible to start Varnish Cache Plus using the normal procedure: /etc/init.d/varnish start

Availability

Relocatable install is supported on Enterprise Linux 6 starting from Varnish Cache Plus 4.0.3r5. Enterprise Linux 7 has the necessary changes, but will require some additional manual steps on installation.

Availability of other Varnish Plus components is limited when running on a relocated installation.