This material is work-in-progress ...

Do not follow instructions here until this notice is removed.
(Last edited by Ttrask on 1 Jun 2015.)

Overview

This page describes how to install a basic provisioning server for SIP devices based upon Postgresql and the ACF web interface. It is built and tested on Alpine Linux 2.7, 3.0, 3.1, and 3.2.

Setup Procedure

1. Configure the machine

Install and configure a basic Alpine Linux server with the ACF web interface.

setup-alpine
setup-acf

2. Install packages

Here are the basic packages for the provisioning functionality:

apk add acf-provisioning acf-postgresql acf-lighttpd

In addition, you can add the firmware packages for the SIP devices you want to support:

apk add acf-provisioning-cisco acf-provisioning-linksys acf-provisioning-polycom acf-provisioning-snom

Note: If you are running-from-RAM, it is recommended to mount /var/ to a hard disk to prevent data loss. If you do so, you should fetch the firmware packages, rather than install them. This way, the firmware will not take up RAM. You can use the following command: apk fetch --quiet --stdout acf-provisioning-polycom

3. Configure Lighttpd

Lighttpd is used to provide the HTTP provisioning interface for the SIP devices. The provisioning package contains a sample configuration that can be used for lighttpd:

mv /etc/lighttpd/lighttpd.conf /etc/lighttpd/lighttpd.conf.orig
ln -s /etc/provisioning/lighttpd.sample.conf /etc/lighttpd/lighttpd.conf

Modify mod_cgi.conf to treat CGI scripts as shell scripts, rather than perl:

sed -i 's~/usr/bin/perl"$~"~' /etc/lighttpd/mod_cgi.conf

Start the server:

/etc/init.d/lighttpd start

4. Start Postgresql

The device parameter details are stored in a Postgresql database. We can use the default configuration, so we just start the service:

/etc/init.d/postgresql start

5. Point your SIP device to the new server for provisioning

ACF Web interface

You can now browse to https://IPADDRESS to access the web interface. To log in for administration, use the root user and the system root password (this is the default configuration set up by setup-acf).