Customer Guide

This page is for customers with valid subscriptions. Please send an email to support@varnish-software.com for support, advice or questions about your Varnish Plus or API Engine instance. Please reach out to sales@varnish-software.com if you have any questions related to subscriptions.

Table of contents


DOCUMENTATION


Technical documentation is available at https://docs.varnish-software.com/.

SUPPORTED PLATFORMS


Varnish Plus

Varnish API Engine

RedHat Enterprise Linux 7

Yes

Yes

RedHat Enterprise Linux 6

Yes

Yes

Ubuntu Linux 14.04 LTS (trusty)

Yes

No

The information above applies to the latest stable release. Older releases may be supported on other platforms.

Repository Configuration


Access to the software repositories requires a valid username and password. Please reach out to support@varnish-software.com if you have questions related to repository configuration.

Varnish Plus 4.1

Red Hat 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-4.1-plus]
name=Varnish Cache Plus
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/varnish-4.1-plus/el$releasever
enabled=1
gpgcheck=0

[varnish-admin-console]
name=Varnish Administration Console
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/vac/el$releasever
enabled=1
gpgcheck=0

Ubuntu

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://USERNAME:PASSWORD@repo.varnish-software.com/GPG-key.txt | 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://USERNAME:PASSWORD@repo.varnish-software.com/ubuntu trusty varnish-4.1-plus

# VAC and Varnish Tuner
deb https://USERNAME:PASSWORD@repo.varnish-software.com/ubuntu trusty non-free

Varnish Plus 4.0

Debian and Ubuntu

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://USERNAME:PASSWORD@repo.varnish-software.com/GPG-key.txt | apt-key add -

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

# Remember to replace DISTRO and RELEASE with what applies to your system.
# distro=(debian|ubuntu), RELEASE=(precise|trusty|wheezy|jessie)

# Varnish Cache Plus 4.0 and VMODs
deb https://USERNAME:PASSWORD@repo.varnish-software.com/DISTRO RELEASE varnish-4.0-plus

# VAC and Varnish Tuner
deb https://USERNAME:PASSWORD@repo.varnish-software.com/DISTRO RELEASE non-free

Red Hat 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.0-plus.repo:

[varnish-4.0-plus]
name=Varnish Cache Plus
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/varnish-4.0-plus/el$releasever
enabled=1
gpgcheck=0

[varnish-admin-console]
name=Varnish Administration Console
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/vac/el$releasever
enabled=1
gpgcheck=0

[varnishtuner]
name=Varnish Tuner
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/varnishtuner/el$releasever
enabled=1
gpgcheck=0

[api-engine]
name=Varnish API Engine
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/api-engine/el$releasever
enabled=1
gpgcheck=0

Varnish Plus 3.0

Debian and Ubuntu

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://USERNAME:PASSWORD@repo.varnish-software.com/GPG-key.txt | apt-key add -

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

# Remember to replace DISTRO and RELEASE with what applies to your system.
# distro=(debian|ubuntu), RELEASE=(precise|trusty|wheezy|jessie)

# Varnish Cache Plus 3.0 and VMODs
deb https://USERNAME:PASSWORD@repo.varnish-software.com/DISTRO RELEASE varnish-3.0-plus

# VAC and Varnish Tuner
deb https://USERNAME:PASSWORD@repo.varnish-software.com/DISTRO RELEASE non-free

Red Hat Enterprise Linux and derivatives

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

[varnish-3.0-plus]
name=Varnish Cache Plus
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/varnish-3.0-plus/el$releasever
enabled=1
gpgcheck=0

[varnish-admin-console]
name=Varnish Administration Console
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/vac/el6
enabled=1
gpgcheck=0

[varnishtuner]
name=Varnish Tuner
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/varnishtuner/el6
enabled=1
gpgcheck=0

[api-engine]
name=Varnish API Engine
baseurl=https://USERNAME:PASSWORD@repo.varnish-software.com/redhat/api-engine/el6
enabled=1
gpgcheck=0

Support


For regular support requests, please send an email to support@varnish-software.com.

To speed up the process, we will often ask you to provide the output from a script called varnishgather. This script will gather relevant configuration and log entries from the system and archive it in a .tar.gz file. This file can then be sent along with the support request.

  1. Download the varnishgather Script from our Github repository.
  2. Upload the file to your Varnish system.
  3. Log in as root.
  4. Run it.
  5. Make the output available to us (preferably by http or email).

For critical support requests where SLA is needed, please contact us by phone (available 24/7).

Support review


Support review is a review of the current setup. When the review is done, we will deliver a report which will be presented in a phone conference where we go through the findings.

Typical findings are related to software versions, VCL configuration optimizations, parameter optimizations and kernel/operating system tuning related to Varnish performance and stability.

The review is done based on the output from varnishgather. The procedure in the support section explains how you can provide us with the output from the gather, which is what's needed to get started.