X-Git-Url: https://git.sesse.net/?p=cubemap;a=blobdiff_plain;f=README;h=4d5d68012106dc25f63e75039a70c6116f2f6173;hp=a8692219df4f22ece9e19481597e76b1ed98b0f2;hb=4a44149acc2d045af71e254d1c6cf16d96a8007f;hpb=aa3c6213114be76ab3adcfc3eeeed7865c746280 diff --git a/README b/README index a869221..4d5d680 100644 --- a/README +++ b/README @@ -1,18 +1,21 @@ Cubemap is a high-performance, high-availability video reflector, -specifically made for use with VLC. It is currently in alpha stage. +specifically made for use with VLC. A short list of features: - - High-performance. Exactly how high-performance remains to be seen, - but it is designed to go to 10 Gbit/sec and beyond, through a - design with multiple worker threads, epoll and sendfile - (yes, sendfile). + - High-performance, through a design with multiple worker threads, + epoll and sendfile (yes, sendfile); a 2GHz quadcore can saturate + 10 gigabit Ethernet, given a modern kernel, a modern NIC + and the right kernel tuning. - High-availability. You can change any part of the configuration (and even upgrade to a newer version of Cubemap) by changing cubemap.config and sending a SIGHUP; all clients will continue as if nothing had happened (unless you delete the stream they are watching, of course). Cubemap also survives the encoder dying and reconnecting. - Per-stream fwmark support, for TCP pacing through tc (separate config needed). + - Support for setting max pacing rate through the fq packet scheduler + (obsoletes the previous point, but depends on experimental kernel patches + that will hit Linux in 3.13 at the earliest) - Reflects anything VLC can reflect over HTTP, even the muxes VLC has problems reflecting itself (in particular, FLV). - IPv4 support. Yes, Cubemap even supports (some) legacy protocols. @@ -42,6 +45,20 @@ are OK, and then exec() the new version, which deserializes everything and keeps going. +Munin plugins: + +To activate these, symlink them into /etc/munin/plugins. If you don't put +the files in the expected default locations (as done by 'make install'), +you probably want some configuration in /etc/munin/plugin-conf.d/cubemap or +similar, like this: + +[cubemap*] +user +env.cubemap_config /etc/cubemap/cubemap.config +env.cubemap_stats /var/lib/cubemap/cubemap.stats +env.cubemap_input_stats /var/lib/cubemap/cubemap-input.stats + + Legalese: Copyright 2013 Steinar H. Gunderson .