Difference between revisions of "BuildingFreeBSD"
(Changed some of the port names to match how they appear in 8.1-RELEASE. Added the mysql plugin port and associated note.)
m (→Compatible FreeBSD Releases)
|Line 7:||Line 7:|
== Mumble Client ==
== Mumble Client ==
Revision as of 23:36, 27 January 2011
Compatible FreeBSD Releases
I can only confirm that Murmur runs on the following FreeBSD releases. However, it should build and run on others just fine. Feel free to edit this to add more versions that you've had success with.
- FreeBSD 7.1
- FreeBSD 7.2
- FreeBSD 8.0
- FreeBSD 8.1
This is a placeholder. This guide is targeted towards Murmur from git at the moment. You should be able to install the Mumble client from ports relatively pain-free:
cd /usr/ports/audio/mumble make install clean
Murmur from git
Grabbing sources from git
I put this part here because I got sick of going over to the Linux page every time I build Murmur on a new machine. If you haven't already installed git:
cd /usr/ports/devel/git make install clean
or for the impatient:
pkg_add -r git
Next, clone the entire repository:
git clone git://mumble.git.sourceforge.net/gitroot/mumble/mumble mumble cd mumble git submodule init git submodule update
Install the dependencies
The following are the main dependencies required for building Murmur 1.2.x from git.
- devel/boost (devel/boost-libs on 8.0+)
- security/openssl (See notes below)
- databases/qt4-mysql-plugin (See note below)
If you want to include Bonjour support, include these deps as well:
security/openssl port: The port isn't required, however at the time of writing there's a rather nasty DoS in QSslSocket which is fixed by upgrading to OpenSSL 0.9.8o or 1.0.0a, neither of which are in base on any current release, but the latter of which is in security/openssl port at the time of writing. However, if you install this port, you'll need to rename /usr/lib/libssl.so to something else, because QT's runtime loader will grab the non-ports libssl and cause you all manner of grief.
databases/qt4-mysql-plugin port: The port is only required if you wish to use the QMYSQL driver.
Note: As of current git (2010-07-03), you must edit src/murmur/murmur.pro and add another include path (/usr/local/share/Ice) to the slice2cpp line (#72 at time of writing), like so:
slice2cpp --checksum -I/usr/local/share/Ice ....
... or you could just symlink that directory to one of the directories the Makefile searches already, or use patch #3026518.
To build the server, Murmur:
qmake-qt4 CONFIG+=no-client CONFIG+=no-dbus CONFIG+=no-bonjour main.pro make release
At the time of writing, if you want to use root certs other than those included with Murmur itself (StartSSL and a couple of others), you'll want to use this qmake line instead of the one above:
qmake-qt4 CONFIG+=no-client CONFIG+=no-dbus CONFIG+=no-bonjour \ DEFINES+="SYSTEM_CA_BUNDLE=/usr/local/share/certs/ca-root-nss.crt" main.pro
Note, I currently don't use CONFIG+=optimize because I'm building on 7.2 and running the binary on 7.1. I have no idea what possible consequences could come of that. I would not expect anything, but I'm just being on the safe side.
I actually prefer to build Murmur in a VM and send builds up to the production server. In case you're wondering, here are the run deps (without Bonjour support):
libprotobuf.so.3 => /usr/local/lib/libprotobuf.so.3 (0x28205000) libcrypto.so.5 => /lib/libcrypto.so.5 (0x282fb000) libIce.so.33 => /usr/local/lib/libIce.so.33 (0x28454000) libIceUtil.so.33 => /usr/local/lib/libIceUtil.so.33 (0x286f9000) libQtSql.so.4 => /usr/local/lib/qt4/libQtSql.so.4 (0x28738000) libQtXml.so.4 => /usr/local/lib/qt4/libQtXml.so.4 (0x28769000) libQtNetwork.so.4 => /usr/local/lib/qt4/libQtNetwork.so.4 (0x287a8000) libQtCore.so.4 => /usr/local/lib/qt4/libQtCore.so.4 (0x28890000) libz.so.4 => /lib/libz.so.4 (0x28a71000) libgthread-2.0.so.0 => /usr/local/lib/libgthread-2.0.so.0 (0x28a83000) libglib-2.0.so.0 => /usr/local/lib/libglib-2.0.so.0 (0x28a88000) libiconv.so.3 => /usr/local/lib/libiconv.so.3 (0x28b38000) libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28c2d000) libm.so.5 => /lib/libm.so.5 (0x28d22000) libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x28d37000) libthr.so.3 => /lib/libthr.so.3 (0x28d42000) libc.so.7 => /lib/libc.so.7 (0x28d60000) libbz2.so.3 => /usr/lib/libbz2.so.3 (0x28e62000) libintl.so.8 => /usr/local/lib/libintl.so.8 (0x28e73000) libpcre.so.0 => /usr/local/lib/libpcre.so.0 (0x28e7c000)
- see Running Murmur for information on how to start the server.
Caveats and Historical problems
When building 1.1.8 or earlier, build fails because of a missing alloca.h header. On FreeBSD, alloca() is declared in stdlib.h, so it's safe to comment the line out (in src/murmur/murmur_pch.h). This has been fixed in git for quite some time, and is apparently fixed in the port of 1.1.8.
Requesting crypt-nonce resync
Crypto was broken on amd64 (and presumably others), however it's fixed in git. If you're trying to build a 1.1.8 server from source, this patch might help.
This was fixed in ports (ports/139384), so if you're building from ports, make sure your ports tree is up to date.