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
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 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:
- Copy Tenfold binary to bin folder:
cp ./asterisk-go-binary_linux_386 /usr/sbin/tenfold
- Copy the Tenfold init.d script. This is used by linux when running service:
cp ./tenfold-initd.sh /etc/init.d/tenfold
- Copy tenfold configuration file. This file must be configured for the application to run (see instructions above).
cp ./tenfold.toml /etc/tenfold.toml
- 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:
- Add to chkconfig:
chkconfig --add tenfold
- Verify is has been added by:
chkconfig --list tenfold
- 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