Upgrading

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

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.

Please note a restart of Varnish is required to complete any upgrade.

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 Enterprise 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 Enterprise 4.1 to 6.0.

Upgrade to Varnish Enterprise 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] (https://www.varnish-cache.org/docs/4.1/whats-new/upgrading.html).

Upgrade to Varnish Enterprise 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.