User Tools

Site Tools


meta:template_howto

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

meta:template_howto [2012/11/10 18:19] (current)
Line 1: Line 1:
 +|:!: **NOTE:** This TEMPLATE is meant for HowTo'​s ​ only. There is a separate one for [[meta:​template_howtobuild|HowToBuild]].|
 +
 +====== Template HowTo ======
 +µMurmur or uMurmur is a minimalistic Mumble server primarily targeted to run on routers with an open OS like OpenWrt.
 +
 +===== Preparation =====
 +==== Prerequisites ====
 +Please read about here [[wp>​OpenWrt]] and here [[doc:​howto:​tc:​tc.theory|theoretical background]]. Read about [[http://​tools.ietf.org/​html/​rfc5246#​page-27|Three Way Hand Shake]], etc.
 +
 +  - follow [[doc/​howto/​usb.essentials]] for a basic USB support (**Do not explain this again!** Link to it, and you're done)
 +  - follow [[doc/​howto/​usb.storage]] for USB storage support
 +  - follow [[doc/​howto/​luci.essentials#​installation]] to install and configure the LuCI WebUI.
 +  - follow [[doc/​howto/​wireless.overview]] for stuff related to wireless
 +  - follow [[doc/​howto/​client.overview#​Mounting.Filesystems]] to mount //any// filesystem.
 +
 +
 +Firewall: ''​portmap''​ uses port 111 TCP + UDP, ''​nfsd''​ uses ports from 32777 to 32780 TCP + UDP. It might be necessary to populate ''/​etc/​hosts.allow''​ to whitelist NFS clients, insert an entry like ''​portmap:​ 192.168.1.*''​.
 +
 +==== Required Packages ====
 +=== Server (OpenWrt) ===
 +  ***''​tc''​** [[http://​linux.die.net/​man/​8/​tc|manpage of tc]]
 +    ***''​kmod-sched''​** (dependency of //tc//), package contains the schedulers
 +  ***''​iptables-mod-ipopt''​** optional! Contains some matches and targets for iptables: CLASSIFY, length, mark/MARK, statistic, tos/TOS
 +    ***''​kmod-ipt-ipopt''​** (user space module; dependency of corresponding user space module; //we need both//, see [[https://​dev.openwrt.org/​ticket/​8294|#​8294]]
 +  ***''​ppp''​** (already in 10.03 RC3 Image)
 +
 +=== Client (your PC) ===
 +For Linux you need ...
 +
 +===== Installation =====
 +[[doc:​techref:​opkg]]
 +<code bash>
 +opkg install umurmur-polarssl
 +vi /​etc/​umurmur.conf
 +. /​etc/​init.d/​umurmur enable
 +. /​etc/​init.d/​umurmur start
 +netstat -a
 +iptables -I INPUT -j ACCEPT -i eth0.1 -p tcp --dport 64738
 +iptables -I INPUT -j ACCEPT -i eth0.1 -p udp --dport 64738
 +</​code>​
 +You should now be able to connect via the mumble protocol.
 +
 +===== Configuration =====
 +==== Server configuration ====
 +Use the file ''/​etc/​exports''​ to configure your shares. Example:
 +<​code>​
 +/​mnt/​sda2 ​  ​192.168.1.2,​192.168.1.3,​192.168.1.4(ro,​sync,​no_subtree_check)
 +/​mnt/​sda3 ​  ​192.168.1.2(rw,​sync,​no_subtree_check)
 +/​mnt/​sda4 ​  ​192.168.1.3(rw,​sync,​no_subtree_check)
 +</​code>​
 +Assuming the daemons are already running, use the command ''​exportfs -ar''​ to reload and apply changes on the fly.
 +
 +==== Network configuration =====
 +Edit your '/​etc/​config/​[[doc:​uci:​network]]'​ file: (see [[doc:​uci:​network#​protocol.3g.ppp.over.ev-do.cdma.umts.or.grps|network 3G section]] for more details)
 +
 +<​code>​
 +config '​interface'​ '​wan'​
 +option '​ifname'​ '​ppp0'​
 +option '​pincode'​ '​1234'​
 +option '​device'​ '/​dev/​ttyUSB0'​
 +option '​apn'​ '​your.apn'​
 +option '​service'​ '​umts'​
 +option '​proto'​ '​3g'​
 +</​code>​
 +
 +Replace '​apn'​ with the correct APN of your 3g/umts provider.
 +
 +Note in case your APN also requires an username/​password,​ you can configure this too, just add to the network configuration file:
 +
 +==== Chap configuration ====
 +
 +
 +
 +==== Client configuration ====
 +=== Linux ===
 +Mount manually:
 +<​code>​
 +sudo mount 192.168.1.254:/​mnt/​share1 /​home/​sandra/​nfs_share
 +</​code>​
 +
 +Or mount permanently with entries in the ''/​etc/​fstab''​ on each client PC:
 +<​code>​
 +# Intranet
 +192.168.1.254:/​mnt/​sda2 /​media/​openwrt ​   nfs     ​ro,​async,​auto ​   0       0
 +192.168.1.254:/​mnt/​sda4 /​media/​remote_stuff ​   nfs     ​rw,​async,​auto ​   0       0
 +#
 +</​code>​
 +
 +Check the [[http://​linux.die.net/​man/​8/​mount|manpage for mount]].
 +
 +=== Windows ===
 +
 +=== Mac OS X ===
 +
 +
 +===== Examples =====
 +   ​*[[doc:​howto:​tc:​tc.example1|example1:​ PRIO one user, simple prioritizing]]
 +   ​*[[doc:​howto:​tc:​tc.example3|example3:​ HFSC several user with all sorts of traffic]]
 +
 +===== Start on boot =====
 +To enable/​disable start on boot:\\
 +''/​etc/​init.d/​umurmur enable'' ​ this simply creates a symlink: ''/​etc/​rc.d/​S90umurmur -> /​etc/​init.d/​umurmur''​\\
 +''/​etc/​init.d/​umurmur disable''​ this removes the symlink again\\
 +
 +===== Administration =====
 +TODO
 +
 +===== Troubleshooting =====
 +If you get something like this:
 +<​code>​
 +Try `iptables -h' or '​iptables --help'​ for more information.
 +</​code>​
 +then bla bla bla
 +
 +===== Notes =====
 +  * The Project Homepage: [[http://​mumble.sourceforge.net/​]]
 +  * a very good tutorial: [[http://​www.frozentux.net/​iptables-tutorial/​iptables-tutorial.html]]
  
meta/template_howto.txt · Last modified: 2012/11/10 18:19 (external edit)