Configure Varnish custom settings on Debian 8 Jessie and Ubuntu 16.04 LTS

Written by - 0 comments

Published on - Listed in Linux Varnish


Earlier this year I installed a new Varnish cluster on Ubuntu 16.04 servers. Cool, the (back then) newest version 4.1 already came from the Ubuntu standard repositories. 

From older systems - Varnish 3.x and 4.0, using the Varnish apt repo - running on Ubuntu 14.04 trusty, I knew I had to configure special settings like listening ports, vcl config files or memory allocation (malloc) in /etc/default/varnish. What strange face I made when all my custom configs didn't work in Xenial anymore! But why?

It took me a while to figure it out. It's Systemd which is (by default) the new init system in Debian 8 Jessie and therefore also Ubuntu 16.04 Xenial (which is based on Jessie). The older init systems (sysvinit or upstart) were able to use special configurations or additional daemon parameters from /etc/default/config files. Systemd does not. So where does one put the custom daemon modifications now?

Back then I also opened a Ubuntu bug report on Launchpad back in April 2016 (bug #1573561) to tell Ubuntu developers to remove the /etc/default/varnish file or to at least add some special notes in it, that it will be ignored by Systemd. One of the responses was a good hint, that the custom options should be set in the varnish's systemd service file. That's what I did, directly in /lib/systemd/system/varnish.service. Not a good idea it turned out.

This week I updated Varnish from 4.1.1-1 to the currently newest version (in Varnish's own apt repo) 4.1.3-1~jessie. Luckily this was only on testing environments, because a few hours later I got notified that all headers, Varnish was supposed to set, disappeared. First I suspected a problem with the newer Varnish version or a (new) incompatibility with the vcl but at the end I saw that /lib/systemd/system/varnish.service was overwritten by the new package. All my custom modifications, including which vcl to use, were gone. No wonder the HTTP headers were gone, too.

In order to use custom settings, which will not be overwritten by a package update, one has to create a special Systemd service file for varnish within /etc/systemd/system. In my case I created /etc/systemd/system/varnish.service which completely replaces the system's /lib/systemd/system/varnish.service. Another alternative would be to create a subfolder "/etc/systemd/system/varnish.service.d" and in there create separate conf files which overwrite single lines (for example only "ExecStart").

This is how my /etc/systemd/system/varnish.service now looks:

root@xenial:~# cat /etc/systemd/system/varnish.service
[Unit

Description=Varnish HTTP accelerator
Documentation=https://www.varnish-cache.org/docs/4.1/ man:varnishd

[Service]
Type=simple
LimitNOFILE=131072
LimitMEMLOCK=82000
ExecStart=/usr/sbin/varnishd -j unix,user=vcache -F -a :6081 -T localhost:6082 -f /etc/varnish/myapp.vcl -S /etc/varnish/secret -s malloc,4096m
ExecReload=/usr/share/varnish/reload-vcl
ProtectSystem=full
ProtectHome=true
PrivateTmp=true
PrivateDevices=true

[Install]
WantedBy=multi-user.target

It basically looks exactly the same as the varnish.service file coming from the varnish package from the Ubuntu repositories - only the ExecStart line differs. However it does look very different to the varnish.service file which comes from the varnish packages installed from the Varnish repository!

After this, Systemd needs to be told to learn about the new varnish.service file:

root@xenial:~# systemctl daemon-reload

That's it! Lesson learned.  


Add a comment

Show form to leave a comment

Comments (newest first)

No comments yet.

RSS feed

Blog Tags:

  AWS   Android   Ansible   Apache   Apple   Atlassian   BSD   Backup   Bash   Bluecoat   CMS   Chef   Cloud   Coding   Consul   Containers   CouchDB   DB   DNS   Database   Databases   Docker   ELK   Elasticsearch   Filebeat   FreeBSD   Galera   Git   GlusterFS   Grafana   Graphics   HAProxy   HTML   Hacks   Hardware   Icinga   Influx   Internet   Java   KVM   Kibana   Kodi   Kubernetes   LVM   LXC   Linux   Logstash   Mac   Macintosh   Mail   MariaDB   Minio   MongoDB   Monitoring   Multimedia   MySQL   NFS   Nagios   Network   Nginx   OSSEC   OTRS   Office   PGSQL   PHP   Perl   Personal   PostgreSQL   Postgres   PowerDNS   Proxmox   Proxy   Python   Rancher   Rant   Redis   Roundcube   SSL   Samba   Seafile   Security   Shell   SmartOS   Solaris   Surveillance   Systemd   TLS   Tomcat   Ubuntu   Unix   VMWare   VMware   Varnish   Virtualization   Windows   Wireless   Wordpress   Wyse   ZFS   Zoneminder