:!: NOTE: This TEMPLATE is meant for HowTo's only. There is a separate one for 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 OpenWrt and here theoretical background. Read about Three Way Hand Shake, etc.

  1. follow usb.essentials for a basic USB support (Do not explain this again! Link to it, and you're done)
  2. follow usb.storage for USB storage support
  3. follow installation to install and configure the LuCI WebUI.
  4. follow wireless.overview for stuff related to wireless
  5. follow 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)

    • 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 #8294
  • ppp (already in 10.03 RC3 Image)

Client (your PC)

For Linux you need …

Installation

opkg

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
You should now be able to connect via the mumble protocol.

Configuration

Server configuration

Use the file /etc/exports to configure your shares. Example:

/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)
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/network' file: (see network 3G section for more details)

config 'interface' 'wan'
option 'ifname' 'ppp0'
option 'pincode' '1234'
option 'device' '/dev/ttyUSB0'
option 'apn' 'your.apn'
option 'service' 'umts'
option 'proto' '3g'

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:

sudo mount 192.168.1.254:/mnt/share1 /home/sandra/nfs_share

Or mount permanently with entries in the /etc/fstab on each client PC:

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

Check the manpage for mount.

Windows

Mac OS X

Examples

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:

Try `iptables -h' or 'iptables --help' for more information.
then bla bla bla

Notes

Back to top

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