The Varnish Enterprise software is currently being built for the ARM CPUs in addition to the x64 CPUs, but not normally distributed to customers. The ARM effort is classified as research, which make the packages purely experimental.
Do not deploy Varnish Enterprise on production servers with ARM processors.
The software is built for ARM for two reasons:
When you are granted access to the experimental ARM software, you will receive an e-mail with credentials for the software and brief installation instructions.
The e-mail will include a token that will be unique to your account, so it will be represented as TOKEN
in this guide.
Installing Varnish Enterprise is basically a two step process:
Customers who are not able to install the software should contact support@varnish-software.com.
Varnish Enterprise for ARM is built for a limited number of platforms which are available from a special experimental repository.
We recommend one of the following distributions:
Note there are no supported platforms for ARM, but we are interested in knowing about any bugs in the experimental software.
Supported platforms are limited to 64bit systems with Intel or AMD processors (x64).
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 -L https://TOKEN:@packagecloud.io/varnishplus/experimental/gpgkey | apt-key add -
To use our Varnish Enterprise repositories, put the following in /etc/apt/sources.list.d/varnish-enterprise-6.0.list
:
# be sure to replace "RELEASE" with
# "bullseye" or "bookworm", depending on your platform
# Varnish Enterprise 6.0 and VMODs
deb https://TOKEN:@packagecloud.io/varnishplus/experimental/debian/ RELEASE main
Finish by updating the apt
database and installing the varnish-plus
package:
apt-get update
apt-get install -y varnish-plus
Transparent Huge Pages is a Linux kernel feature to improve performance by more efficiently using a processors’ memory mapping hardware. This is a feature that is enabled by default on most recent Linux distributions.
Varnish does not perform well with this option enabled. As such, Transparent
Huge Pages should be set to either madvice
or never
on any system where Varnish is operating.
The procedure to disable THP will vary based on the distribution being used. Please consult with the manual for your distribution for the correct steps to take.
The shared memory log contains file which are used for communicating
logs and counters to log consumers like varnishncsa
and
varnishlog
. In some circumstances, having these files on a physical
medium can create performance problems. For this reason it is strongly
recommended to mount the /var/lib/varnish/
directory as a tmpfs
file system.
If you choose to limit the size of the tmpfs
file system, a
reasonable size is three times the varnishd
parameter vsl_space
.