4PSA VoipNow Core® Professional 2.0.3
Command Line Installation

Manual Version 64775.1 at 2010/03/16 17:40:27

For suggestions regarding this manual contact: docs@4psa.com

Copyright © 2002-2010 Rack-Soft, Inc.

All rights reserved

Distribution of this work or derivative of this work is prohibited unless prior written permission is obtained from the copyright holder.

VoipNow is a Registered Trademark of Rack-Soft, Inc.

4PSA is a Registered Trademark of Rack-Soft, Inc.

PowerPC is a Registered Trademark of the International Business Machines Corporation.

Asterisk is a Trademark of Digium, Inc.

Linux is a Registered Trademark of Linus Torvalds.

All other trademarks and copyrights are property of their respective owners.

Table of Contents

RPM Packages Included in the Distribution
RPM Packages Requirements
RPM Package Conflicts
Before Starting the Installation
Installation Steps
Upgrade
Start/Stop Scripts
Compatibility
Get Support
Contact Information
20 minutes
It will take about 20 minutes to an intermediate user to read this document and follow the steps highlighted here.

RPM Packages Included in the Distribution

  • /Third_Party.OS - All packages from this directory are standard open source packages. They are shipped with the product due to the lack of OS support or because the versions shipped with the OS do not satisfy the 4PSA VoipNow Core requirements. The list below could be different depending on the operating system the distribution is built for.
    • libmad - standard libmad library, required by SoX
    • sw-libxml2* - standard libxml2 library, required by voipnow2-admin-php
    • libmcrypt - standard libmcrypt library, required by voipnow-admin-php
    • mhash - standard mhash library, required by voipnow-admin-php
    • MySQL* - standard MySQL 5.1 server packages, required by 4PSA VoipNow Core
    • perl-DBD-MySQL51 - standard Perl DBD package, compiled for MySQL 5.1.x
    • perl-Asterisk-AGI - Perl support for Asterisk
    • libosptk - standard OSP Toolkit library, required by Asterisk
    • libtonezone2 - standard tonezone2 library, required by Asterisk
    • python-rrdtool - standard python rrdtool , required by 4PSA VoipNow Core
    • gsm - standard gsm library, required by Asterisk
    • speex - standard speex library, required by Asterisk
    • rrdtool - standard rrdtool, required by 4PSA VoipNow Core
    • libmemcached - standard memcached library, required by 4PSA VoipNow Core
    • mysql51-python - standard MySQL python libraries compiled for MySQL 5.1.x
    • graphviz - standard graphviz tools, required by voipnow-core
    • voipnow-spandsp - standard spandsp library recompiled for VoipNow Core
    • j2re - Java 2 runtime environment, required by gapslite
  • /Third_Party - All packages from this directory are Open Source. They are patched and custom compiled by 4PSA. Installing another package with the same name will most likely break the installation.
    • voipnow-sox - SoX utils, custom compiled with libmad support
    • voipnowcore-admin - Lighttpd server used by 4PSA VoipNow Core to run the interface
    • voipnowcore-admin-php - PHP support for the Lighttpd server
    • voipnowcore-asterisk - Asterisk, patched and custom compiled
    • voipnow-asterisk-sounds - Sounds for Asterisk, patched and custom compiled
    • voipnow-asterisk-addons - Add-ons for Asterisk, patched and custom compiled
    • voipnowcore-kamailio - Kamailio SIP server patched and custom compiled
    • voipnow-memcached - Memcached daemon patched and custom compiled
    • dahdi - Digium telephony drivers, patched and custom compiled
    • libpri - C implementation of the Primary Rate ISDN specification, patched and custom compiled
    • gapslite - Grandstream provisioning binary, packed in RPM format
  • /Voipnow - 4PSA VoipNow Core proprietary software packages.
    • voipnowcore-asterisk-extra - 4PSA VoipNow Core applications for Asterisk
    • voipnowcore-core - 4PSA VoipNow Core low level scripts
    • voipnowcore-php - 4PSA VoipNow Core PHP interface

RPM Packages Requirements

4PSA VoipNow Core requires the following standard RPM packages:

  • libvorbis
  • sharutils
  • ntp
  • curl
  • dos2unix

Make sure that these packages are installed. The product will refuse to install if any required package is missing. Depending on your operating system, you can install any package using the automatic RPM package managers.

Note

Redhat Enterprise Linux 5, CentOS 5.x users can execute:

> yum install <package_name>

RPM Package Conflicts

Make sure that the following packages are not installed on your system:

  • sox
  • httpd
  • asterisk
  • asterisk-sounds
  • asterisk-addons

If you have any one of these packages installed, remove them before starting the RPM installation.

Before Starting the Installation

In order to install 4PSA VoipNow Core, the MySQL server should not be configured. During the installation, 4PSA VoipNow Core will attempt to reconfigure MySQL. If you want to install 4PSA VoipNow Core on a configured MySQL server (a server on which you cannot connect with username root and empty password), before installing the RPMs, export the following variables:

  • ALT_DB_USER - MySQL root username
  • ALT_DB_HOST - MySQL host
  • ALT_DB_PORT - MySQL port
  • ALT_DB_PASSWD - The ALT_DB_USER password

The ALT_DB_USER, ALT_DB_PASSWD, ALT_DB_HOST, ALT_DB_PORT will be used by the installer to connect to the configured MySQL server, in place of the root username and the empty password.

Note

This guide only covers installation on a single server. For deployments on multiple servers, please open a support ticket in the 4PSA Help Desk Center.

Installation Steps

  1. Make sure that yum RPM is installed on your server.

  2. Log in to your server as root (you can use SSH from Linux or Putty client from Windows).

  3. To download the installer script on your server, execute the following command:

    wget http://www.4psa.com/software/voipnowcoreinstaller.sh

  4. Run the installer script by executing:

    sh voipnowcoreinstaller.sh

    Have some patience. The script will download all the RPM packages from the repository and will try to install them.

Upgrade

In order to upgrade the system, you must execute the same steps like in the product installation (described above).

Warning

During a software upgrade the Asterisk daemon is restarted. This means that all current calls will be dropped. We recommend you to perform upgrades when the phone system is not in use.

In order to view the phone system utilization, you can execute in following command line:

> asterisk -rx "show channels"

The upgrade might take several minutes, especially when a large database is affected. It is recommended to use the command line updater when upgrading between major versions (from example from 2.0.3 to 2.1.0).

DO NOT press CTRL-C during RPM installation as your installation can be left in an inconsistent state! If you experience any problem during the upgrade, do not hesitate to open a support ticket in the 4PSA Help Desk Center.

Start/Stop Scripts

The following daemons are used by the 4PSA VoipNow Core. If one of these daemons is down, the system might not be able to process calls.

  • MySQL-server - the MySQL database server
  • asterisk - the Asterisk PBX telephony server
  • kamailio - the Kamailio server used to act as a SIP proxy for Asterisk
  • vdialroute - the call routing server (used for external calls)
  • voipnow - the Apache server used to display the 4PSA VoipNow Core interface

The startup scripts can be found in the /etc/init.d/ directory.

Compatibility

4PSA VoipNow Core is compatible with the following operating systems:

  • Redhat Enterprise Linux Server 5.0 (i386/x86_64)
  • CentOS 5.x (i386/x86_64)

Get Support

For online help and support please visit the below areas:

Contact Information

Development office:

Rack-Soft SRL
DCL Office Building, 20-22 Bilciuresti Street, sector 1
Bucharest, 014012
ROMANIA
Phone: 646-957-8997 (US), 021-3130165 (Romania)
Fax: 270-638-0988 (US), 021-3130165 (Romania)

E-mail: