Installing ASTPP on MXLinux

This tutorial will guide you through the steps to install ASTPP, an open-source VoIP billing solution, on the latest version of MXLinux.

Prerequisites

Before we begin with the installation of ASTPP, ensure that:

• You have root access to the server.
• You have Python 2.7 installed on the server.
• You have functional working Apache and MySQL services installed on the server.

Step 1: Update the server

The first step is to ensure that the server is updated to its latest version. You can do this with the following command:

sudo apt update && sudo apt upgrade

Step 2: Install dependencies

Next, install the required dependencies for ASTPP with the following command:

sudo apt install python-mysqldb python-imaging python-setuptools build-essential python-dev libapache2-mod-wsgi libradiusclient-ng-dev git

Step 3: Download ASTPP

Now, we need to download ASTPP from its official website. You can do this with the following command:

sudo git clone https://github.com/astpp/astpp.git

Step 4: Install ASTPP

Before we start with the installation, we need to make sure that our working directory is inside the downloaded directory of ASTPP. For this, use the following command:

cd astpp

Once you are inside the working directory, you can use the following command to install ASTPP:

sudo ./install.sh

This will start the installation process, which may take a few minutes to complete.

Step 5: Configure ASTPP

After installation, we need to configure ASTPP to work with Apache and MySQL. For this, create a new configuration file with the following command:

sudo nano /etc/astpp/astpp.conf

Now, add the following lines to the configuration file:

dbhost = localhost
dbport = 3306
dbname = astpp
dbusername = YOUR-DB-USERNAME
dbpassword = YOUR-DB-PASSWORD

Replace YOUR-DB-USERNAME and YOUR-DB-PASSWORD with your MySQL username and password, respectively.

Save and exit the configuration file.

Step 6: Create a Virtual Host

Next, we need to create a virtual host for ASTPP on Apache. For this, create a new virtual host file with the following command:

sudo nano /etc/apache2/sites-available/astpp.conf

Add the following lines to the virtual host file:

<VirtualHost *:80>
	ServerName YOUR.DOMAIN.NAME
	ServerAdmin YOUR.EMAIL.ADDRESS
	DocumentRoot /var/www/html
	WSGIDaemonProcess astpp user=astpp group=astpp processes=2 threads=25 python-path=/usr/local/bin/python2.7:/var/www/astpp:/var/lib/python2.7/dist-packages
	WSGIScriptAlias / /var/www/astpp/public/py.wsgi
	<Directory />
		Options FollowSymLinks
		AllowOverride All
	</Directory>
	<Directory /var/www/astpp>
		Options Indexes FollowSymLinks MultiViews
		AllowOverride All
		Order allow,deny
		allow from all
	</Directory>
	ErrorLog ${APACHE_LOG_DIR}/error.log
	LogLevel warn
	CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Replace YOUR.DOMAIN.NAME and YOUR.EMAIL.ADDRESS with your domain name and email address, respectively.

Save and exit the virtual host file.

Step 7: Enable the Virtual Host

Now, we need to enable the virtual host with the following command:

sudo a2ensite astpp

Next, disable the default virtual host:

sudo a2dissite 000-default

Restart the Apache service with the following command:

sudo service apache2 restart

Step 8: Test ASTPP

To test ASTPP, open your web browser and enter your domain name in the address bar.

You should see the ASTPP login page. Enter the default username and password:

Username: admin
Password: 1234

You should now be logged in to the ASTPP dashboard.

Congratulations! You have successfully installed and configured ASTPP on MXLinux.