Murmur
Murmur is the server component to Mumble built on the Qt framework. See uMurmur for a lighter weight embedded version.
Installation
USE flags
USE flags for net-voip/murmur Mumble is an open source, low-latency, high quality voice chat software
Emerge
root #
emerge --ask net-voip/murmur
Configuration
Files
- /etc/murmur/murmur.ini - Daemon configuration file.
- /etc/conf.d/murmur - OpenRC service configuration file.
- /usr/lib/systemd/system/murmur.service - systemd service configuration file.
Services
OpenRC
To have the murmur daemon run on system boot, issue:
root #
rc-update add murmur default
To start murmur, issue:
root #
rc-service murmur start
systemd
To have the murmur daemon run on system boot, issue:
root #
systemctl enable murmur.service
To start murmur on systemd, issue:
root #
systemctl start murmur.service
Usage
Initial setup
After the emerge, pay attention to the einfo message that is printed; it contains important setup information. It will likely look similar to the following message.
* Useful scripts are located in /usr/share/doc/murmur-1.3.4/scripts.
* Please execute:
* murmurd -ini /etc/murmur/murmur.ini -supw <pw>
* chown murmur:murmur /var/lib/murmur/murmur.sqlite
* to set the build-in 'SuperUser' password before starting murmur.
* Please restart dbus before starting murmur, or else dbus registration
* will fail.
*
* (Note: Above message is only printed the first time package is
* installed. Please look at /usr/share/doc/murmur-1.3.4/README.gentoo*
* for future reference)
You must also set at least pidfile
in the /etc/murmur/murmur.ini file, otherwise the init will not see the service as started. Specifying the logfile
is also a nice thing, as service spits out a warning about failing to open it:
; If set, Murmur will write its process ID to this file
; when running in daemon mode (when the -fg flag is not
; specified on the command line). Only available on
; Unix-like systems.
pidfile=/run/murmur/murmur.pid
; Specifies the file Murmur should log to. By default, Murmur
; logs to the file 'murmur.log'. If you leave this field blank
; on Unix-like systems, Murmur will force itself into foreground
; mode which logs to the console.
logfile=/var/log/murmur/murmur.log
Gaining SuperUser privileges
A SuperUser account is created by default on every instance of a Murmur service. This account is created to assist in administration tasks such as kicking or banning an abusive user or quickly creating new channels. In order to obtain SuperUser privileges, the correct password must be used. The SuperUser password is written to the Murmur log file (/var/log/murmur/murmur.log). Use any pager program or text editor to view the log (for security reasons the log is only view able for users with root privileges), or simply grep for the following line:
root #
cat /var/log/murmur/murmur.log | grep "Password for 'SuperUser'"
Once the password has been obtained, use a client to connect to the server as the user called "SuperUser". Instructions on adding SuperUser privileges to other accounts can be found here on the Mumble wiki.
Removal
Unmerge
root #
emerge --ask --depclean --verbose net-voip/murmur
See also
- uMurmur — a minimalistic server for Mumble designed to run on embedded systems (DD-WRT or OpenWRT) or older PC hardware.
- Mumble — an open source, cross platform, low-latency, high quality voice over IP (VoIP) client.
External resources
- http://wiki.mumble.info/wiki/MurmurGuide - The Mumble wiki's guide for running Murmur (covers Windows and Linux).