GUI Installation

This guide provides a comprehensive overview of installing, reinstalling, and upgrading the VoIPmonitor web GUI. It covers both first-time installations and common maintenance scenarios like fixing a corrupted installation or upgrading after a PHP version change.

Part 1: First-Time Installation

If you are installing VoIPmonitor for the very first time on a new server, we provide detailed, step-by-step guides tailored to specific Linux distributions. These guides cover all necessary dependencies, including the web server, PHP, and the IonCube Loader.

Please select the guide that matches your operating system from the main Installation Section.

Part 2: Reinstalling or Upgrading the GUI

This procedure is the correct solution for several common scenarios:

• Fixing a Corrupted Installation: If the GUI was damaged during a failed upgrade (e.g., due to a power loss or full disk).
• Upgrading after a PHP Version Change: If you have upgraded your server's operating system or PHP version and the GUI no longer loads.
• Manually Upgrading to the Latest GUI: To get the newest features and bug fixes.

This process overwrites the core application files but preserves your database and `config/configuration.php` file.

Step 1: Check Your Current PHP Version

The GUI package is compiled for a specific major PHP version. First, SSH into your server and determine which version is active for your web server.

php --version

Note the version number (e.g., `8.1`, `8.2`, `7.4`).

Step 2: Back Up Your Current GUI Directory

Before making any changes, create a full backup of your existing GUI web directory. This allows for an easy rollback if needed.

# The default path is /var/www/html, adjust if yours is different
sudo cp -a /var/www/html /var/www/html-backup-$(date +%F)

Step 3: Install or Update the IonCube Loader

The VoIPmonitor GUI is protected with IonCube, which requires a specific loader extension for your PHP version.

A. Find Your PHP Extension Directory

# This command will show you the path where PHP extensions should be placed
php -i | grep ^extension_dir

The output will be something like `extension_dir => /usr/lib/php/20210902 => /usr/lib/php/20210902`. Note this path.

B. Download the Correct IonCube Loader

Use `wget` to download the loader that matches your PHP version (e.g., `8.1`) into the extension directory.

# Example for PHP 8.1. Replace "8.1" with your version.
# Replace "/usr/lib/php/20210902" with the path from the previous command.
sudo wget http://voipmonitor.org/ioncube/x86_64/ioncube_loader_lin_8.1.so -O /usr/lib/php/20210902/ioncube_loader_lin_8.1.so

C. Create the IonCube Configuration File

You must create a `.ini` file to tell PHP to load the extension. This needs to be done for both the web server and the command-line interface (CLI).

# Example for PHP 8.1 on Debian/Ubuntu with Apache. Adjust paths as needed.
echo 'zend_extension = ioncube_loader_lin_8.1.so' | sudo tee /etc/php/8.1/apache2/conf.d/00-ioncube.ini
echo 'zend_extension = ioncube_loader_lin_8.1.so' | sudo tee /etc/php/8.1/cli/conf.d/00-ioncube.ini

D. Restart the Web Server

sudo systemctl restart apache2

• (Or `nginx`, `php-fpm` depending on your setup)*

Step 4: Download and Run the GUI Installer

1. Create a temporary directory and download the GUI package

This command downloads the latest GUI package. Replace `81` with your PHP version number (e.g., `82` for 8.2, `74` for 7.4).

mkdir /tmp/voipmonitor-gui-reinstall
cd /tmp/voipmonitor-gui-reinstall

# Example for PHP 8.1
wget "https://www.voipmonitor.org/download-gui?version=latest&major=5&allowed&phpver=81" -O gui.tar.gz

2. Extract the archive and run the installation script

tar xzf gui.tar.gz
cd voipmonitor-gui-*/scripts/
sudo bash install-gui.sh ../../gui.tar.gz

The script will prompt you to confirm the installation path. Press Enter to confirm the default (e.g., `/var/www/html`).

Step 5: Finalize in Your Browser

After the script completes, you must finalize the process in your web browser.

• Open the VoIPmonitor GUI.
• Perform a hard refresh to bypass your browser's cache. The shortcut is Ctrl+Shift+R (or Cmd+Shift+R on Mac).

This final step loads all new assets and completes the update. Your GUI should now be fully functional.

Installing a Development Build

If the support team provides you with a link to a development build to fix a specific issue, the process is very similar to a manual reinstall.

1. Back up your current GUI directory as shown in Step 2 above. 2. Download the specific `.tar.gz` file using the link provided by the support team. 3. Extract and run the `install-gui.sh` script as shown in Step 4 above. 4. Finalize in your browser with a hard refresh as shown in Step 5.

AI Summary for RAG

Summary: This guide provides a comprehensive tutorial for installing, reinstalling, and upgrading the VoIPmonitor web GUI. It directs new users to the main distribution-specific installation guides. The core of the article is a detailed, five-step process for reinstalling the GUI, which is the recommended solution for fixing a corrupted installation or upgrading after a PHP version change. The steps include: 1) Checking the active PHP version with `php --version`. 2) Backing up the existing web directory. 3) A detailed subsection on installing the correct IonCube Loader for the new PHP version. 4) Downloading the correct GUI package using `wget` and running the `install-gui.sh` script. 5) Finalizing the process with a hard browser refresh (Ctrl+Shift+R). The guide also covers the similar process for installing a specific development build provided by the support team. Keywords: install, reinstall, upgrade, gui, web interface, php, ioncube, `install-gui.sh`, corruption, php upgrade, `php --version`, ioncube loader, `a2enmod`, hard refresh Key Questions:

• How do I reinstall the VoIPmonitor GUI?
• What should I do if the GUI is broken after an update or PHP upgrade?
• How do I install the IonCube Loader for a new version of PHP?
• What are the steps to run the `install-gui.sh` script?
• How can I safely back up my GUI files before a reinstallation?
• How do I download the latest GUI for a specific PHP version?
• How to install a development version of the GUI provided by support?