How to Install ASTPP on OpenSUSE

ASTPP is an open-source VoIP billing system that simplifies billing and operational procedures for VoIP providers. This tutorial details the steps required to install ASTPP on the latest version of OpenSUSE.

Prerequisites

A freshly installed OpenSUSE system with root access.
Internet connectivity for downloading the required dependencies

Step 1: Update and Upgrade System

Before installing ASTPP, update your system to ensure that all packages are up-to-date. To update the system, execute the following command in the terminal:

sudo zypper update

Step 2: Install Dependencies

With the updated system, the next step is to install the dependencies required for ASTPP installation. Some of the packages to install are listed below:

Apache web server,
PHP 7.2 or later, and
MariaDB 10.2 or later.

To install these dependencies, execute the following command:

sudo zypper install apache2 mariadb mariadb-client mariadb-tools php php-mysqlnd php-pdo php-gd php-xml php-mbstring composer

Once the installation is complete, start the Apache and MariaDB services, and enable them to run automatically on system boot:

sudo systemctl start apache2
sudo systemctl enable apache2

sudo systemctl start mariadb
sudo systemctl enable mariadb

Step 3: Download and install ASTPP

To download the latest stable release of ASTPP from their official website, execute the below command:

wget -O astpp.tar.gz https://github.com/ASTPP/ASTPP/releases/download/v3.7.3/astpp.tar.gz

Unzip the downloaded package and move it to the web directory:

tar -xzf astpp.tar.gz
sudo mv ASTPP /srv/www/htdocs/

Step 4: Install ASTPP Dependencies

Navigate to the ASTPP directory and install its dependencies using Composer:

cd /srv/www/htdocs/ASTPP
sudo composer install --no-dev

Step 5: Configure MariaDB

Create a new database for ASTPP, and a user account with full privileges to the database:

sudo mysql -u root

CREATE DATABASE astpp;
CREATE USER 'astpp'@'localhost' IDENTIFIED BY 'astpp@123';
GRANT ALL PRIVILEGES ON astpp.* TO 'astpp'@'localhost' IDENTIFIED BY 'astpp@123';
FLUSH PRIVILEGES;
EXIT;

Step 6: Install ASTPP Database Scheme

Use the following command to import the SQL script to create ASTPP tables and filled demo data:

sudo mysql -u root astpp < /srv/www/htdocs/ASTPP/install/sql/astpp.sql

Step 7: Configure ASTPP

The final step is to configure ASTPP. Edit the ASTPP configuration file to meet the required configuration by executing:

sudo nano /srv/www/htdocs/ASTPP/configs/global.inc.php

Search for the following section in the file, uncomment and set the corresponding values:

/*configure database*/
define('DB_HOSTNAME', 'localhost');
define('DB_USERNAME', 'astpp');
define('DB_PASSWORD', 'astpp@123');
define('DB_NAME', 'astpp');

Save and exit the file by pressing Ctrl + x, then Y.

Step 8: Access ASTPP

With the configuration complete, you can now go ahead and access ASTPP using your web browser. Access http://<your_server's_IP_address>/ASTPP/public and use the default login details below:

Username: [email protected]
Password: admin

After logging in, the system will prompt you to change your password for security purposes.

Conclusion

In conclusion, you have successfully installed ASTPP billing system on OpenSUSE. You can now configure the application and start using it for VoIP billing.