This is documentation for Web Call Server 3.x

Take a look at our newest product Web Call Server 5

Web Call Server 5 product page

Installation

This manual consist information about Flashphoner installation procedure


Hostname issue

Server may not start properly due the hostname issue.

For example your hostname is:

#hostname
myhost-test.com

In such case you have to add the hostname to /etc/hosts

127.0.0.1 localhost myhost-test.com

To install Flashphoner you need root access to your server by SSH connection and software for work through this protocol (Putty, for instance).
After connecting to the server, follow this steps from the command line (shell).

Typical Flashphoner installation has two phase: preparing environment and Flashphoner installation

Preparing environment

  1. Download and install latest JDK
  2. Create symlink using ln command:
    $ ln -sf /usr/java/default/bin/java /usr/bin

Flashphoner installation

  1. Download Flashphoner Web Call Server installer (see actual download link here):
    $ wget http://flashphoner.com/.../.../FlashphonerWebCallServer....tar.gz
  2. Unpack archive
    $ tar -xvzf WebCallServer-....tar.gz
  3. Give to script permission to run:
    $ chmod +x install.sh
  4. Run installer and provide needed information
    $ ./install.sh
  5. Start installation process
    $ Enter
  6. After installation complete run activation script and enter your license key. You can get Free license key here
    $ ./activation.sh
  7. After activation complete you will need to get Flashphoner-WCS-client (see below)
IMPORTANT
Make sure you have specified correct ip and ip_local properties during installation process. Check flashphoner.properties file before starting Flashphoner Web Call Server.
See Configuring section for more details.

Flashphoner-WCS-client

  1. Make sure, you have installed Flashphoner Web Call Server
  2. Download Flashphoner-WCS-client-3.x.y.tar.gz
    $ wget http://flashphoner.com/.../.../Flashphoner-WCS-client....tar.gz
  3. Unpack it
    $tar -xvzf Flashphoner-WCS-client-...tar.gz
  4. Just copy content to web directory and customize WCS server IP in flashphoner.xml file.

Uninstall

Flashphoner will remove all libs and configs during uninstall process.
You can backup current settings using such commands:

$cd /usr/local/FlashphonerWebCallServer
$tar -cvzf backup.tar.gz lib conf bin

You can uninstall Flashphoner using such commands:

$cd /usr/local/FlashphonerWebCallServer
$./flashphoner-uninstall.sh

JVM, JDK

If your system architect is x86_64, you should use JVM 64-bit
How to check this:

$uname -a

Result:
2.6.18-164.el5xen #1 SMP Thu Sep 3 04:03:03 EDT 2009 x86_64 x86_64 x86_64 GNU/Linux

$java -version

Result:
java version "1.6.0_21"
Java(TM) SE Runtime Environment (build 1.6.0_21-b06)
Java HotSpot(TM) 64-Bit Server VM (build 17.0-b16, mixed mode)

Some pre-installed JVMs does not support 64-bit mode. Uninstall such JVM using rpm, or other way, and download latest JDK from orcale.com  and install it.

IP and IP_LOCAL settings

Flashphoner requires ip and ip_local settings during installation process.

  • ip - is external IP address of the server
  • ip_local - is local ip address of the server
    See several rules below, to specify this settings.
How to specify ip
  1. You may use such services to detect ip: http://www.ip-adress.com http://www.whatismyip.com/ http://whatismyipaddress.com/ http://www.ipaddrs.com/ e.t.c.
  2. If the server has LOCAL LAN ip only, e.g. 192.168.1.10, specify this ip address here.
How to specify ip_local
  1. If the server is behind the NAT(external ip is not equals LAN ip) and has LOCAL LAN ip, e.g. 192.168.1.10, specify this ip address here.
  2. If the server has EXTERNAL ip only, specify the EXTERNAL ip address here.
You can change ip and ip_local settings after installation in flashphoner.properties. See configuring section

Examples:

Environment ip ip_local
The server is closed in LAN 192.168.1.2 192.168.1.2
The server is behind the NAT 168.144.196.170
192.168.1.2 
The server is in WAN 168.144.196.170
168.144.196.170

JDK HOME installation problem

Flashphoner requires JDK 1.6 and greater, because it uses JNI interfaces.You can download Java Platform, Standard Edition here: http://www.oracle.com/technetwork/java/javase/downloads/index.html

JRE without JDK is not suitable for Flashphoner

During installation process Flashphoner trying to define JDK_HOME itself. If it impossible - Flashphoner will ask you specify this path manually.

"Specify manually" does not mean "export JDK_HOME environment variable".It means "type your JDK_HOME path in the installation dialog".

JDK_HOME folder should contain file /include/jni.hYou can check if your JDK_HOME path contain /include/jni.h by command

$ls -l JDK_HOME

This command will show all content of your JDK_HOME folder

Wrong JDK_HOME* (/usr/java/latest/jre/ not contain include folder)

Click here to expand...

Correct JDK_HOME (/usr/java/default/ containt include folder)

Click here to expand...

ServerId

serverId is the unique identifier of Flashphoner server.
It generated during installation procedure.
You can find serverId here - /usr/local/FlashphonerWebCallServer/conf/flashphoner.serverid

How to resolve serverId generation issue
  1. Install Flashphoner. Don't worry about installation warnings about license key and serverId.
  2. Check serverId file. If it is empty - remove this file.
  3. Restart server and make one call.

ServerId should be generated. See serverId file.

Labels

install install Delete
installation installation Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.