VoipNow® Professional 2.5.0
Command Line Installation

Manual Version 69764.4 at 2010/08/03 21:14:57

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

Copyright © 2005-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.

Linux is a Registered Trademark of Linus Torvalds.

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

Table of Contents

Overview
RPM Package Conflicts
Installation Steps
Upgrade
Cepstral Text2Speech Engine Installation
Compatibility
Get Support
Contact Information
15 minutes
It will take about 15 minutes to an intermediate user to read this document and follow the steps highlighted here.

Overview

VoipNow Professional can be installed on an existing 32bit or 64bit server connected to the Internet and running Redhat Enterprise Linux 4, Redhat Enterprise Linux 5, CentOS 4.x and CentOS 5.x. VoipNow Professional is packed using RPM packages, which are available on a standard yum repository. You do not have to download and install the packages manually, the installation process, which involves dependency resolution is automated using the command line installer.

The server where you plan to install VoipNow Professional should be exclusively used for this purpose only, because any other services running on the same machine can affect the QoS parameters. If you have a small installation and you do not want to waste resources, you should consider virtualization. VoipNow Professional is compliant with virtualized environments like VMware, Virtuozzo, Xen, KVM, etc. For many environments it is also available in pre-packaged templates.

This guide assumes that VoipNow Professional is installed on a single hardware node, it does not apply for 4Grid deployments.

RPM Package Conflicts

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

  • sox
  • httpd
  • asterisk
  • asterisk-sounds
  • asterisk-addons
  • mysql*

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

Installation Steps

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

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

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

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

  4. Run the installer script by executing:

    sh voipnowinstaller.sh

    Have some patience. The script will download all the RPM packages from the repository, will install them and will configure the system. During the installation, you can choose if you want the installer to download and compile the Dahdi kernel drivers. This is necessary only if you want to add to the server a hardware card for interfacing to PSTN network using ISDN PRI. It is not recommended to install the Dadhi drivers otherwise.

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 all calls are dropped. We recommend you to perform upgrades when the phone system is not in use and to schedule this operation

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

DO NOT press CTRL-C during RPM installation as your installation can become inconsistent. If you experience any problem during the upgrade do not hesitate to open a support ticket in the 4PSA Support Zone at https://help.4psa.com.

Cepstral Text2Speech Engine Installation

In order to use the VoipNow Professional text2speech engine (TTS), you must install the Cepstral voice you want to use and the matching licenses. The Cepstral voices can be downloaded from the Cepstral website:

http://www.cepstral.com/downloads/

After downloading the voice archive on the server, untar it with:

> tar -zxf voice_name.tar.gz

Change to the new created directory:

> cd voice_name_directory

and execute the installer:

> sh install.sh

then follow the indications. You basically have to accept the license agreement and to press Y on all prompts. The default settings are OK.

Cepstral requires a license key. Licenses are per voice and per concurrency ports. If you want to use a voice, for example Callie,you must acquire and install the:

  • voice license for Callie
  • a concurrency license - The concurrency license allows you to use text2speech from multiple concurrent calls. This is required if you want to text2speech with more than a call at the same time.

To install a voice license you must execute:

> swift --reg-voice

To install a ports license you must execute:

> swift --reg-ports

Cepstral licenses can be purchased from 4PSA Online Store. Bundles of 3, 10 and 20 concurrent ports are offered.

Compatibility

VoipNow Professional is compatible with the following operating systems:

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

Get Support

For online help and support please visit the below areas:

Contact Information

Development office:

Rack-Soft SRL
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: