Varnish Cache Plus

Installation

Introduction

The Varnish Plus offering has Varnish Cache Plus in its core, and most other components interact with it in one way or another. It is recommended that you install this first, but some other components (like the Varnish Administrator Console) can be installed independently of Varnish Cache plus.

When you sign up for Varnish Cache Plus you will get a welcome letter with the necessary information to install Varnish Cache Plus. The letter will include a user name and password embedded in the recipie, but we will use the place holders user and passwd in this guide.

Varnish Cache Plus is distributed in prepackaged form for the most common Linux operating system distributions.

The list of supported distributions are:

  • RedHat Enterprise Linux 6
  • RedHat Enterprise Linux 7
  • Ubuntu Linux 14.04 LTS (trusty)

Legacy versions have different sets of supported platforms.

Varnish Cache Plus is supported on 64bit systems with Intel or AMD processors (x64).

Installing Varnish Cache Plus

Installing Varnish Cache Plus is basically a two step process:

  1. Configure the repository for your Linux distribution
  2. Install the software using the built in package manager

Customers who cannot locate their user name and password should contact support@varnish-software.com.

Repository configuration Varnish Cache Plus 4.1

RedHat Enterprise Linux and derivatives

To use our Varnish Plus repositories on version 6 and 7, put the following in /etc/yum.repos.d/varnish-4.1-plus.repo:

[varnish-plus-41]
name=varnish-plus-41
baseurl=https://TOKEN:@packagecloud.io/varnishplus/41/el/$releasever/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://TOKEN:@packagecloud.io/varnishplus/41/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

Note that for RHEL/CentOS platforms, it is necessary to install the epel-release package to provide access to VCP dependencies.

Ubuntu 14.04

Packages in our repositories are signed and distributed via HTTPS. You need to enable HTTPS support in the package manager and install our public key first:

apt-get install -y apt-transport-https
curl https://TOKEN:@packagecloud.io/varnishplus/41/gpgkey | apt-key add -

To use our Varnish Plus repositories, put the following in /etc/apt/sources.list.d/varnish-4.1-plus.list:

# Varnish Cache Plus 4.1 and VMODs
deb https://TOKEN:@packagecloud.io/varnishplus/41/ubuntu/ trusty varnish-4.1-plus

Install through the package manager

After the repositories have been added, you can install the software.

RedHat Enterprise Linux and derivatives

Varnish Cache Plus is available through the varnish-plus package:

yum update
yum install varnish-plus

Ubuntu / Debian variants

Varnish Cache Plus is available through the varnish-plus package:

apt-get update
apt-get install varnish-plus

Installing Varnish modules

In 4.1 many Varnish modules (VMODs) are embedded in the varnish-plus package, and no extra installation is required.

Modules with third-party package dependencies (libcurl, libmemcached) are available in a separate package called varnish-plus-vmods-extra. This package is not installed by default.

In legacy versions VMODs are either available in repository packages called vmod-NAME or libvmod-NAME (VCP3.0), or more recently in the varnish-plus-vmods package (VCP4.0).

The source code for some of these VMODs are available at https://github.com/varnish/varnish-modules/.