| Both sides previous revision Previous revision Next revision | Previous revision |
| docs:user-guide:services:umurmur [2018/02/20 20:52] – ↷ Links adapted because of a move operation | docs:guide-user:services:voip:umurmur [2023/12/12 12:20] (current) – Remove out-dated mention of PolarSSL and mention certificate generation bug with Mbed-TLS iguanajuice |
|---|
| µMurmur or uMurmur is a minimalistic [[wp>Mumble (software)]] server primarily targeted to run on embedded devices with an open OS like OpenWrt. | µMurmur or uMurmur is a minimalistic [[wp>Mumble (software)]] server primarily targeted to run on embedded devices with an open OS like OpenWrt. |
| |
| Project page for more info and most up-to-date documentation at http://code.google.com/p/umurmur/ | Project page for more info and most up-to-date documentation at https://github.com/umurmur/umurmur |
| |
| ===== Preparation ===== | ===== Preparation ===== |
| ==== Prerequisites ==== | ==== Prerequisites ==== |
| So far there are two uMurmur packages available in the repos, one compiled against the PolarSSL library and one against the OpenSSL library. The PolarSSL variant needs less storage //and// less RAM: | So far there are two uMurmur packages available in the repos, one compiled against the Mbed-TLS library and one against the OpenSSL library. |
| |
| <code> | <code> |
| opkg info umurmur-polarssl | opkg info umurmur-mbedtls |
| opkg info umurmur-openssl | opkg info umurmur-openssl |
| </code> | </code> |
| |
| __Firewall:__ The default ports are 64738 tcp and 64738 udp. [[doc/uci/firewall#opening.ports|open]] them up in ''[[docs:user-guide:firewall:firewall_configuration|/etc/config/firewall]]''. | __**Note**__ that currently, the Mbed-TLS version does not auto-generate a certificate, causing it to not startup correctly. It is therefor suggested to use the OpenSSL version for the time being. |
| | |
| | See this GitHub issue: [[https://github.com/openwrt/packages/issues/22188]] |
| | |
| | __Firewall:__ The default ports are 64738 tcp and 64738 udp. [[docs:guide-user:firewall:fw3_configurations:fw3_config_examples#opening_ports_on_the_openwrt_router|open]] them up in ''[[docs:guide-user:firewall:start|/etc/config/firewall]]''. |
| |
| |
| ==== Required Packages ==== | ==== Required Packages ==== |
| The following list specifies package versions for latest stable release of OpenWRT. At time of writing Backfire 10.03.1. | The following list specifies package versions for latest stable release of OpenWrt. At time of writing, 23.05. |
| === Server (OpenWrt) === | === Server (OpenWrt) === |
| ^ Name ^ Version ^ Size ^ Description ^ | ^ Name ^ Version ^ Size ^ Description ^ |
| | umurmur-polarssl | 0.2.6-1 | 39696 | Minimalistic Mumble server daemon. Uses the PolarSSL library for SSL and crypto. | | | umurmur-openssl | 0.2.20-2 | 36762 | Minimalistic Mumble server daemon. Uses OpenSSL library for SSL and crypto. | |
| | libpolarssl | 0.14.3-1 | 95679 | Embedded SSL (library) | | | libopenssl3 | 3.0.12-1 | 1394609 | The OpenSSL Project is a collaborative effort to develop a robust, commercial-grade, full-featured, and Open Source toolkit implementing the Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1) protocols as well as a full-strength general purpose cryptography library. This package contains the OpenSSL shared libraries, needed by other programs. | |
| | libconfig | 1.4.7-1 | 19143 | Libconfig is a simple library for manipulating structured configuration files. This file format is more compact and more readable than XML. And unlike XML, it is type-aware, so it is not necessary to do string parsing in application code. Libconfig is very compact -- just 38K for the stripped C shared library (less than one-fourth the size of the expat XML parser library) and 66K for the stripped C++ shared library. This makes it well-suited for memory-constrained systems like handheld devices. | | | libconfig11 | 1.7.3-1 | 15719 | Libconfig is a simple library for manipulating structured configuration files. This file format is more compact and more readable than XML. And unlike XML, it is type-aware, so it is not necessary to do string parsing in application code. Libconfig is very compact -- just 38K for the stripped C shared library (less than one-fourth the size of the expat XML parser library) and 66K for the stripped C++ shared library. This makes it well-suited for memory-constrained systems like handheld devices. | |
| ^ Name ^ Version ^ Size ^ Description ^ | | libprotobuf-c | 1.4.1-1 | 9922 | Runtime library to use Google Protocol Buffers from C applications. Protocol Buffers are a way of encoding structured data in an efficient yet extensible format. Google uses Protocol Buffers for almost all of its internal RPC protocols and file formats. | |
| | umurmur-openssl | 0.2.6-1 | 40391 | Minimalistic Mumble server daemon. Uses OpenSSL library for SSL and crypto. | | |
| | libopenssl | 0.9.8r-1 | 510041 | The OpenSSL Project is a collaborative effort to develop a robust, commercial-grade, full-featured, and Open Source toolkit implementing the Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1) protocols as well as a full-strength general purpose cryptography library. This package contains the OpenSSL shared libraries, needed by other programs. | | |
| | libconfig | 1.4.7-1 | 19143| Libconfig is a simple library for manipulating structured configuration files. This file format is more compact and more readable than XML. And unlike XML, it is type-aware, so it is not necessary to do string parsing in application code. Libconfig is very compact -- just 38K for the stripped C shared library (less than one-fourth the size of the expat XML parser library) and 66K for the stripped C++ shared library. This makes it well-suited for memory-constrained systems like handheld devices. | | |
| |
| === Client (your PC) === | === Client (your PC) === |
| Example using shell access: | Example using shell access: |
| <code bash> | <code bash> |
| opkg install umurmur-polarssl | opkg install umurmur-openssl |
| vi /etc/umurmur.conf | vi /etc/umurmur.conf |
| /etc/init.d/umurmur enable | /etc/init.d/umurmur enable |
| Check log output that the ''uMurmurd'' started up OK. | Check log output that the ''uMurmurd'' started up OK. |
| |
| [[doc/uci/firewall#opening.ports|open]] port 64738 for TCP and UDP in ''[[docs:user-guide:firewall:firewall_configuration|/etc/config/firewall]]''. | [[docs:guide-user:firewall:fw3_configurations:fw3_config_examples#opening_ports_on_the_openwrt_router|open]] port 64738 for TCP and UDP in ''[[docs:guide-user:firewall:start|/etc/config/firewall]]''. |
| |
| <code bash> | <code bash> |
| - Read about certificates in general. Do it! [[wp>Public key certificate]] | - Read about certificates in general. Do it! [[wp>Public key certificate]] |
| - enlighten your friends, there is no point in security if not all users understand the principle of operation | - enlighten your friends, there is no point in security if not all users understand the principle of operation |
| * Project Homepage: [[http://code.google.com/p/umurmur/]] | * Project Homepage: [[https://github.com/umurmur/umurmur]] |