4.3 KiB
Compiling aprsc from source
WARNING: THIS DOCUMENT CURRENTLY DOCUMENTS FUTURE FUNCTIONALITY - THE CONFIGURE SCRIPT IS NOT QUITE FINISHED YET AND YOU CAN'T MAKE INSTALL EITHER.
If you're familiar with compiling software from the source code, and pre-built binary packages are not available for your platform, this is where you need to start. Binary packages are provided for Debian and Ubuntu systems.
aprsc has been built and tested on:
- Ubuntu LTS (10.04, 12.04)
- Debian stable (6.0, "squeeze")
- Debian 5.0 "lenny": i386 and x86_64
- Mac OS X 10.8 (Snow Leopard): x86
- FreeBSD 8.2 and 9.0 on amd64, 7.2 on i386
- Solaris 11 (SunOS 5.11 11.0 i86pc i386)
- Raspberry Pi (Raspbian): ARM11/ARMv6
If you wish to have decent support, please pick Debian or Ubuntu. The other platforms do work, but when it comes to building and installing, you're mostly on your own.
Prerequirements and dependencies
aprsc requires a recent gcc version (4.1 or later) to compile due to the need for built-in functions for atomic memory access.
aprsc also requires libevent2 (libevent version 2.0), since libevent's HTTP server is used to implement the status page and HTTP position upload services.
libevent2 is available in the most recent Linux distributions (apt-get install libevent or libevent2, but check if it's a 2.0). Older versions do not come with it, so you need to download it and compile it from source (http://libevent.org/).
libevent2 is also available in MacPorts for OS X and FreeBSD ports.
Preparing the environment
Create user account and group for aprsc. aprsc should be started as root, but a non-privileged user account must be provided, so that it can switch to that after starting up.
Linux (single command, all parameters are for adduser):
adduser --system --no-create-home --home /var/run/aprsc
--shell /usr/sbin/nologin --group aprsc
Compiling aprsc
Delete old version if necessary:
$ rm aprsc-latest.tar.gz
Download the latest source tree:
$ wget http://he.fi/aprsc/down/aprsc-latest.tar.gz
Extract it:
$ tar xvfz aprsc-latest.tar.gz
Go to the newly-created directory and configure the build:
$ cd aprsc-1.0.0 (or whatever)
$ ./configure
At this point the configuration either succeeds or fails. If it fails, it is probably due to a missing dependency, in which case it tries to tell clearly what is missing. If your platform does not appear in the list of tested platforms, the failures might be more "interesting".
On FreeBSD, with libevent2 installed from ports, you'll have to do this:
CFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib/event2 ./configure
On Mac OS X, with libevent2 installed from MacPorts, use:
CFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib ./configure
If you've installed libevent2 from sources with it's default configuration on any Unix-like system, the FreeBSD example above (pointing to /usr/local) should probably work.
With build configuration done:
Compile it:
$ make
Install it:
$ sudo make install
Install example configuration:
$ sudo make installconf
You should now have a nice installed set of software in /opt/aprsc.
A note on the chroot
aprsc is usually run in a chroot, which prevents it from accessing any files outside of the chroot directory after it has started up. If the default path of internal logging to file and internal log rotation is used, the logs need to be below the chroot directory. Since configuration reloads need to be supported, the configuration needs to be there too. This is why aprsc is installed within a single /opt/aprsc directory tree with configs in /opt/aprsc/etc and logs in /opt/aprsc/logs.
It is possible to enable logging to syslog by reconfiguring syslogd to provide an additional UNIX domain socket within the chroot. However, due to the various different syslogds in wide use, the default aprsc installations do not make any attempt at this.
Downloading older versions of aprsc
Head to source code downloads !
It's also possible to browse and download source code and inspect changes made in the software in github, which is used for version control and patch management in aprsc.