User Tools

Site Tools


meta:template_howto

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
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.1352567948.txt.bz2 · Last modified: 2012/11/10 18:19 (external edit)