X-Git-Url: http://git.harvie.cz/?p=svn%2FPrometheus-QoS%2F.git;a=blobdiff_plain;f=INSTALL;h=45a86f9fa06512160af7224e654dcee30e5572ae;hp=302cafdbc0e168a05a5a3633be895f2115b60efb;hb=1c004f157fcfa04aa9b9361266fb2b84645c6f33;hpb=a4f661fc8c4d2ef31306e8d4d6f8b0b310623919 diff --git a/INSTALL b/INSTALL index 302cafd..45a86f9 100644 --- a/INSTALL +++ b/INSTALL @@ -1,25 +1,40 @@ -Prometheus QoS Installation Guide: +Prometheus QoS installation - canonical + +1. run "./check-kernel-qos" script to check kernel modules HTB and SFQ (optional) +2. as a root, run "make install" (you shouldn't get errors, just some warnings) +3. edit /etc/prometheus/prometheus.conf (conf/prometheus.conf or examples/...) +4. edit /etc/prometheus/hosts (conf/prometheus.hosts or examples/...) +5. edit /etc/cron.d/prometheus to update preview, shutdown and reload times +6. run "/etc/init.d/prometheus start" to activate QoS +7. run "/etc/init.d/prometheus stop" to shutdown QoS and generate stats +8. run "/etc/init.d/prometheus kill" to force immediate flush of QoS rules +9. setup /etc/init.d/prometheus to your system init (distribution dependent) + +Prometheus QoS installation - alternative, old way 1. if can read read this, you have already unpacked the .tar.gz archive -2. type "make prometheus" +enter (you shouldn't get errors...) -3. create /etc/prometheus.conf (see prometheus.conf.SAMPLE or sample-configuration/*) -4. create /etc/hosts (or /etc/qos.conf, see hosts.SAMPLE or sample-configuration/*) -5. to activate QoS manualy from command line, just type ./prometheus -6. to softly shutdown QoS (and generate stats), type ./prometheus -f ("flush") -7. to force immediate flush of QoS rules, type ./prometheus -9 ("kill") - -Promethetus QoS Advanced tips: - -1. I prefere to launch prometheus using "screen" utitlity (not tested without it) -2. use -p command line switch to generate instant and safe Hall of fame preview -3. use qos-free-delay option for pause after flushing old rules/before loading new -4. use magic-relative-limit option to fine tune your Fair Use Policy (daily quotas) -5. note: qos-proxy-enable and qos-free-zone won't work together -6. you can setup /etc/crontab using /sample-configuration/crontab.SAMPLE -7. warning: doing SNAT and QoS on the same router may cause performance problems +2. run "make prometheus" (you shouldn't get errors, just some warnings) +3. create /etc/prometheus/prometheus.conf (conf/prometheus.conf or examples/...) +4. create /etc/prometheus/hosts (conf/prometheus.hosts or examples/...) +5. to activate QoS manualy from command line, just run "./prometheus" +6. to softly shutdown QoS (and generate stats), run "./prometheus -f" ("flush") +7. to force immediate flush of QoS rules, run "./prometheus -9" ("kill") + +Promethetus QoS advanced tips: + +1. use -p command line switch to generate instant and safe Hall of fame preview +2. use qos-free-delay option for pause after flushing old rules, before loading new +3. take some time to understand files examples/prometheus.conf and examples/hosts +4. note: qos-proxy-enable and qos-free-zone won't work together +5. warning: doing SNAT and QoS on the same router may cause performance problems General Linux routing tips for beginners: echo -n 1 > /proc/sys/net/ipv4/ip_forward echo -n 64000 > /proc/sys/net/ipv4/ip_conntrack_max echo -n 86400 > /proc/sys/net/ipv4/netfilter/ip_conntrack_tcp_timeout_established + +Prometheus Debian packages: + +1. you need root access and "debhelper" package installed +2. run "make deb" or "sudo make deb"