Manual Version 41859.8 at 2008/05/14 16:25:14
For suggestions regarding this manual contact: docs@4psa.com
Copyright © 2002-2008 Rack-Soft, LLC
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, LLC.
4PSA is a Registered Trademark of Rack-Soft, LLC.
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
20 minutes
|
| It will take about 20 minutes to an intermediate user to read this document and follow the steps highlighted here. |
-
/Third_Party.OS- All packages in 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 requirements. The list below could be different depending on the operating system the distribution is built for.-
libmad- standard libmad library, required by sox -
libxml2*- standard libxml2 library, required by voipnow-admin-php -
libmcrypt- standard libmcrypt library, required by voipnow-admin-php -
mhash- standard mhash library, required by voipnow-admin-php -
MySQL*- standard MySQL 5 server packages, required by 4PSA VoipNow -
perl-DBD-MySQL- standard Perl DBD package, compiled for MySQL 5 -
perl-Asterisk-AGI- Perl support for Asterisk -
snapdsp- standard snapdsp libraries -
graphviz- standard graphviz tools, required by voipnow-core -
j2re- Java 2 runtime environment, required by gapslite
-
-
/Third_Party- All packages in 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 -
voipnow-admin- Apache server used by 4PSA VoipNow to run the interface -
voipnow-admin-php- PHP support for the Apache server -
voipnow-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 -
zaptel- 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 software packages, proprietary packages.-
voipnow-asterisk-extra- 4PSA VoipNow applications for Asterisk -
voipnow-core- 4PSA VoipNow low level scripts -
voipnow-php- 4PSA VoipNow PHP interface
-
4PSA VoipNow requires the following standard RPM packages:
-
libvorbis -
sharutils -
ntp -
curl
Make sure that these packages are installed. The product will refuse to install if any required package is not installed. Depending on your operating system, you can install any package using the automatic RPM package managers.
Redhat Enterprise Linux 3, Redhat Enterprise Linux 4 users can execute:
> up2date <package_name>
Fedora Core 4, Fedora Core 5, Redhat Enterprise Linux 5, CentOS 3.x , CentOS 4.x and CentOS 5.x users can execute:
> yum install <package_name>
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.
In order to install 4PSA VoipNow, the MySQL server should not be configured. During the installation 4PSA VoipNow will attempt to reconfigure MySQL. If you want to install 4PSA VoipNow 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_PASSWD- Password for theALT_DB_USER
The ALT_DB_USER and the ALT_DB_PASSWD will
be used by the installer to connect to the configured MySQL server, in
place of the root username and the empty password.
-
Make sure that
yum RPMis installed on your server. -
Log in to your server as root (you can use "SSH" from Linux or "Putty" from Windows).
-
To download the installer script on your server, execute the following command:
wget http://www.4psa.com/software/voipnowinstaller.sh -
Run the installer script by executing:
sh voipnowinstaller.shHave some patience. The script will download all the RPM packages from the repository and will try to install them. During the installation, you can choose if you want the installer to download and compile the Zaptel kernel drivers. This is necessary only if you want to add to the server a hardware card for interfacing to PSTN providers. If you want to use only VoIP, this step is not required.
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 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 1.4.2 to 1.5.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 at https://help.4psa.com.
The following daemons are used by the 4PSA VoipNow. 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
- vdialroute - the call routing server (used for external calls)
- voipnow - the Apache server used to display the 4PSA VoipNow interface
The startup scripts can be found in the directory /etc/init.d/.
In order to use the 4PSA VoipNow text2speech engine, 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.
4PSA VoipNow is compatible with the following operating systems:
- Redhat Enterprise Linux Server 5.0 (IBM PowerPC64)
- Redhat Enterprise Linux Server 5.0 (i386/x86_64)
- Redhat Enterprise Linux (AS/ES) 4 (i386/x86_64)
- Redhat Enterprise Linux (AS/ES) 3 (i386)
- CentOS 5.x (i386/x86_64)
- CentOS 4.x (i386/x86_64)
- CentOS 3.x (i386)
- Fedora Core 5 (i386)
- Fedora Core 4 (i386)
- Suse Linux 10.0 (i386)
For online help and support please visit the below areas:
- Knowledge Base: http://kb.4psa.com
- Help Desk Center: https://help.4psa.com
- Forums: http://forum.4psa.com
- Report Bugs: http://www.4psa.com/company/bugreport.php
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:
- For purchasing and sales information, email sales@4psa.com
- For partnership opportunities, email channel@4psa.com
- For translations and localization, email docs@4psa.com