Differences

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

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]]

Back to top

meta/template_howto.txt · Last modified: 2012/11/10 18:19 (external edit)