Skip to main content

Install the Tenfold Asterisk Binary Connector

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

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.

Automatic installation (recommended)

From the command line, run the install script:

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 1. Update the organization

If your organization ID is 579a691ddbb6fdf00bcab682

organization = "579a691ddbb6fdf00bcab682" 
username = "<your_ami_username>" 
secret = "<your_ami_password>" 
port = "5038" 
host = "127.0.0.1" 


Run:

service tenfold start

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

Manually install a service (advanced)

Download and unzip the appropriate package for your system architecture:

For Linux i386:

curl https://storage.googleapis.com/tenfold-asterisk-
connect/linux/386/tenfold-386.tar.gz

For Linux amd64:

curl https://storage.googleapis.com/tenfold-asterisk-connect/linux/amd64/tenfold-amd64.tar.gz

Move or copy the files as follows:

  1. Copy Tenfold binary to the 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 the 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.

Configure Linux to run the Tenfold binary in the background

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
In this section: