Varnish Cache Plus

Upgrading

This is a description in general terms how to upgrade to newer versions of Varnish Cache Plus.

Many (most) of the changes needed will be identical to a Varnish Cache upgrade, so the open-source documentation is referenced below.

These instructions are not meant to be copied verbatim, but rather give an indication of the considerations and steps necessary when upgrading.

Support can help out with VCL configuration changes between versions.

Minor version upgrades

Upgrades between minor versions, for example from 4.0.3r4 to 4.0.3r5, are considered stable and will not require manual intervention.

Upgrade to Varnish Cache Plus 6.0

Upgrading from 4.1 should be straight forward, but there are some important changes that might force you the update your VCL and settings. Read more about this on Configuration and VCL changes when upgrading from Varnish Cache Plus 4.1 to 6.0.

Upgrade to Varnish Cache Plus 4.1

Upgrade from 4.0 to 4.1 are usually straight forward.

Before the upgrade the list of supported platforms should be reviewed.

Software update

On Enterprise Linux:

mv /etc/yum.repos.d/varnish-4.0-plus.repo /etc/yum.repos.d/varnish-4.1-plus.repo
sed -i -e 's|4.0-plus|4.1-plus' /etc/yum.repos.d/varnish-4.1-plus.repo
yum clean metadata
yum update varnish-plus

On Ubuntu 14.04 LTS (trusty):

mv /etc/apt/sources.list.d/varnish-4.0-plus.list /etc/apt/sources.list.d/varnish-4.1-plus.list
sed -i -e 's|4.0-plus|4.1-plus' /etc/apt/sources.list.d/varnish-4.1-plus.list
apt-get update
apt-get upgrade varnish-plus

On all platforms the varnish-plus-vmods package has been retired. Modules are now embedded in the main varnish-plus package.

The varnish-plus-vmods-extra package is still available.

Configuration update

VCL code only requires minimal changes, see the Varnish Cache page on this topic.

Upgrade to Varnish Cache Plus 4.0

Between 3.0 and 4.0 there were significant changes to VCL, which made the transition more difficult than was expected.

Main upgrade documentation can be found online: https://www.varnish-cache.org/docs/4.0/whats-new/upgrading.html

The most common substitutions can be done automatically using the Varnish 3 to 4 script.