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.
Upgrades between minor versions, for example from 4.0.3r4
to 4.0.3r5
, are
considered stable and will not require manual intervention.
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 from 4.0
to 4.1
are usually straight forward.
Before the upgrade the list of supported platforms should be reviewed.
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.
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).
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.