Asterisk Binary Connector

Last updated: 2-20-2017

Note: You will need root access to the server that is hosting the Asterisk system. The Host IP and AMI credentials should be available at Company Settings > Phone System. It will be listed in the host. The commands will be listed in this article but some familiarity with a command line is recommended.  

Overview

The Tenfold Asterisk Binary Connector adds a redundant event stream from your Asterisk server to Tenfold Servers. This article will cover installation.

Automatic Installation (recommended)

From the command line, run the install script by:

curl https://storage.googleapis.com/tenfold-asterisk-connect/install.sh | sh

The install script will automatically perform the “manual” setup steps below. Should the script fail at any point refer to those instructions to recover.

Open /etc/tenfold.toml with a text editor (nano or vim). Update the organization with your organization ID and Asterisk AMI username and secret. Make sure all values are given with quotes.

Example:

If your organization ID is 579a691ddbb6fdf00bcab682

Run:

service tenfold start

This should start the Tenfold daemon as a service. Tenfold should automatically start if the server is rebooted.

Manually Install as a Service (advanced)

Download and unzip the appropriate package for your system architecture:
Linux i386
curl https://storage.googleapis.com/tenfold-asterisk-connect/linux/386/tenfold-386.tar.gz
Linux amd64
curl https://storage.googleapis.com/tenfold-asterisk-connect/linux/amd64/tenfold-amd64.tar.gz

First, move/copy the files:

1. Copy Tenfold binary to bin folder:
   cp ./asterisk-go-binary_linux_386 /usr/sbin/tenfold
2. Copy the Tenfold init.d script. This is used by linux when running service:
   cp ./tenfold-initd.sh /etc/init.d/tenfold
3. Copy tenfold configuration file. This file must be configured for the application to run (see instructions above).
   cp ./tenfold.toml /etc/tenfold.toml
4. Set permissions for each of the files
   chown root /usr/sbin/tenfold
chown root /etc/tenfold.toml
chmod 777 /etc/init.d/tenfold

At this point the application is runnable (assuming tenfold.toml is set correctly). The next steps involve configuring Linux to run the Tenfold binary as a service in the background. This is how the Asterisk software itself runs.

Asterisk PBXs typically have chkconfig installed to run services. If this is installed perform the following:

1. Add to chkconfig:
   chkconfig --add tenfold
2. Verify is has been added by:
   chkconfig --list tenfold
3. Tell chkconfig to run the Tenfold binary on boot by:
   chkconfig tenfold on

Alternatively, if you are using a newer version of Linux you may use systemd
update-rc.d tenfold enable

Configure your /etc/tenfold.toml. Then you may start the binary by running the following:
service tenfold start

If it is already running and you make a change to the binary or config file you may restart by running:
service tenfold restart

To stop the service run
service tenfold stop