Skip to content

Latest commit

 

History

History
79 lines (54 loc) · 2.25 KB

INSTALL.rst

File metadata and controls

79 lines (54 loc) · 2.25 KB
Raw

INSTALLATION

RPMs

Binary, debuginfo and source RPMs for VMOD re are available at:

https://pkg.uplex.de/

The packages are built for Enterprise Linux 7 (el7), and hence will run on compatible distros (such as RHEL7, Fedora, CentOS 7 and Amazon Linux).

To add the repo to your YUM configuration:

yum-config-manager --add-repo https://pkg.uplex.de/rpm/7/uplex-varnish/x86_64/

The RPM for the VMOD requires a Varnish installation from the official packages:

https://packagecloud.io/varnishcache

You can then install the VMOD with:

yum install --nogpgcheck vmod-selector

If you have problems or questions concerning the RPMs, post an issue to the source repository web site for the VMOD, or contact <[email protected]>.

Fedora

The VMOD has also been packaged for Fedora distros (since Fedora 28):

https://pkgs.org/download/vmod-uuid

To install the VMOD for Fedora, run:

dnf install vmod-uuid

Building from source

The VMOD is built against a Varnish installation, and the autotools use pkg-config(1) to locate the necessary header files and other resources for Varnish. The development version of the OSSP uuid library must also be installed, typically provided as a package named uuid-devel.

This sequence will install the VMOD:

> ./autogen.sh        # for builds from the git repo
> ./configure
> make
> make check          # to run unit tests in src/tests/*.vtc
> sudo make install

See CONTRIBUTING.rst for more detailed information for developers.

If you have installed Varnish in a non-standard directory, call autogen.sh and configure with the PKG_CONFIG_PATH environment variable set to include the paths where varnishapi.pc can be located. For example, when varnishd configure was called with --prefix=$PREFIX, use:

> PKG_CONFIG_PATH=${PREFIX}/lib/pkgconfig
> export PKG_CONFIG_PATH

By default, the vmod configure script installs the vmod in the same directory as Varnish, determined via pkg-config(1). The vmod installation directory can be overridden by passing the VMOD_DIR variable to configure.

Other files such as the man-page are installed in the locations determined by configure, which inherits its default --prefix setting from Varnish.