View Source

This page contains instructions on how to install or upgrade VoipNow in the operating system command line.

If something is unclear or you need further assistance, do not hesitate to open a ticket in the 4PSA Support Zone or ask a question in our monitored GetSatisfaction community.

Installation

For all new installations, we strongly recommend Red Hat Enterprise Linux 7 Update 2 (or newer) or CentOS 7.1 running on 64 bit. Before proceeding with the installation of VoipNow on a new server:

Make sure you have reviewed the Release Notes, as they always contain important advice regarding the upgrade.
Check if the date and time on that server are correct. Using a NTP service to keep the clock synchronized is required.

If you're upgrading to VoipNow 5.2.5 from VoipNow 4.1.3 or a previous version, please read the following:

On MySQL database

VoipNow 5.2.5 contains significant MySQL database optimizations. Unfortunately, due to the schema changes the update might take hours time on a large database. However, we made available a script that updates the database prior to the VoipNow 5.2.5 upgrade, without downtime.

So, it's highly recommended to download this script from https://www.4psa.com/software/voipnow5dbupgrade.sh and run it on the Infrastructure Controller overnight or when the database is not heavily utilized.

System functionality will not be impacted while the script is running. Once the script has completed, you can proceed with VoipNow installation.

On Hubring database

If you are running a distributed setup with more than one Hubring node, please open an upgrade assistance ticket in 4PSA Help Desk.

To install VoipNow:

Log in to your server as root using SSH from any client operating system.
Download the installer script on your server by executing the command below.
curl "http://www.4psa.com/software/voipnowinstaller.sh" -o voipnowinstaller.sh -L
Run the installer script by executing the following command.
sh voipnowinstaller.sh

Wait patiently as the installer downloads all the packages from the repository, installs them, and configures the system.

Optional components

PSTN interface card drivers

During the setup process, the VoipNow Installer asks if you want the Dahdi kernel drivers to be configured.

This is strictly necessary only if you installed an ISDN PRI interface card to the server. Otherwise, installing Dahdi drivers is not recommended.

Most installations do not use ISDN interfaces, as this method of interacting with the PSTN network is obsolete.

Upgrade

Before you start

There is not much to do, but do it properly:

Make sure that you understand the implications of the upgrade.
During a software upgrade process, all phone calls are dropped. Consequently, it is recommended that you perform such upgrades outside business hours.
The upgrade might take several minutes, especially on systems with large databases. DO NOT interrupt the VoipNow Installer by pressing CTRL-C or rebooting the system, as your upgrade might become inconsistent!
The upgrade process will take longer if there are many CDRs on the system. This happens because tables are converted from MyISAM to INNODB and it only occurs once, when upgrading from VoipNow 3 to VoipNow 3.5.
To avoid this conversion, run export DONOT_INNODB=1 before executing the installer.

To upgrade VoipNow:

Log in to your server as root using SSH from any client operating system.
Download the latest installer script on your server by executing the command below.
curl "http://www.4psa.com/software/voipnowinstaller.sh" -o voipnowinstaller.sh -L
Run the installer script by executing the following command.
sh voipnowinstaller.sh