Regards to freshing up the website
phk at phk.freebsd.dk
Thu Apr 8 22:39:09 CEST 2010
Sorry for the delay, still digging through my mailbox...
I have recently been using the Python docs a fair bit, and I sort
of like how they have done it: An installation document, A tutorial
to get you started, and a reference document with all the nitty-gritty
I would like to see the Varnish documentation develop along the same lines,
here is a strawman index:
on this os, pull this package
.. that ..//..
to compile from source
how to get help
- mailing list
- other listed consultants
- using varnishtest to reproduce
- what data do we need
starting varnish with -d, seeing a transaction go through
explain varnishlog output for a miss and a hit
a few simple VCL tricks, including switching VCL on the fly
The helpers: varnishstat, varnishhist, varnishtop varnishncsa
Now that you know how it works, lets talk planning:
- backend, directors and polling
- management CLI & security
Real life examples:
- A real life varnish explained
- A more complex real life varnish explained
- Sky's Wikia Setup
- What varnishtest does and why
- writing simple test-cases
- using varnishtest to test your VCL
- using varnishtest to reproduce bugs
. varnishd manual page
. - counters explained
. common filtering options for shmlog tools
. varnishlog ..
. varnsihtop ..
. varnsihncsa ..
. varnsihhist ..
. connections: -T -S -M
. CLI commands and what they do
. - vcl.load
. - stop
. - start
. - ...
. The functions:
. - vcl_recv
. - vcl_miss
. The things you can do
. - set
. - unset
. - esi
. - rollback
. syntax etc.
Poul-Henning Kamp | UNIX since Zilog Zeus 3.20
phk at FreeBSD.ORG | TCP/IP since RFC 956
FreeBSD committer | BSD since 4.3-tahoe
Never attribute to malice what can adequately be explained by incompetence.
More information about the varnish-misc