Installation

his manual consist information about Flashphoner installation procedure

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 1.6
2. Create symlink using ln command:
   $ln -sf /usr/java/default/bin/java /usr/bin
3. Downoad and install latest WowzaMediaServer from wowzamedia.com. Get serial number for 10 connetcs developer license here: http://www.wowza.com/store.html
4. Start WowzaMediaServer using such commands and enter your serial number:
   $cd /usr/local/WowzaMediaServer/bin
   $./startup.sh
   Press Ctrl+C to stop server.
5. Install gcc and make using yum or your custom packet manager:
   $yum install -y gcc
   $yum install -y make

Flashphoner installation

1. Download Flashphoner installer (see actual download link here):
   $ wget http://flashphoner.com/downloads/Flashphoner-x.x.x.xxx.tar.gz
2. Unpack archive
   $ tar -xvzf Flashphoner-x.x.x.xxx.tar.gz
3. Give to script permission to run:
   $ chmod +x install.sh
4. Run installer
   $ ./install.sh
5. Start installation process
   $ Enter
6. After installation complete, your Flashphoner has Free 10-connects Developer License. You can upgrade it to Unlimited License

IMPORTANT Make sure you have specified correct ip and ip_local properties during installation process. Check flashphoner.properties file before starting Wowza Media Server. See Configuring section for more details.

See also: Possible installation problem with JDK HOME

Flashphoner-client installation

1. Make sure, you have installed Flashphoner-server, see Flashphoner-installation section
2. Download Flashphoner-client-1.x.y.tar.gz
3. $tar -xvzf Flashphoner-client-1.x.y.tar.gz
4. $cd Flashphoner-client-1.x.y
5. $chmod +x install.sh
6. $./install.sh
7. Specify client-dir during installation. The installer will copy client files(html, js, swf, e.t.c) into this dir.
   If you have specified client-dir as apache web-dir /var/www/html/myflashphoner or similar, you can open the page in browser: http://mydomain/myflashphoner/flashphoner_client/PhoneJS.html
   You can also copy these files into your local file system and open page in browser: file:///C:/temp/flashphoner_client/PhoneJS.html
8. Make sure, flashphoner_client/flashphoner.xml file has correct rtmp server url.

Applying the patch

May be you will need install latest Flashphoner patch. See downloads page to get latest Flashphoner patch for given release.

Please, create backup of WowzaMediaServer/lib directory before applying the patch

1. Download Flashphoner patch.
   $ wget http://flashphoner.com/downloads/Flashphoner-1.0.x.xxx-p.yyy.tar.gz
   where x.xxx - patched version, yyy - patching version
2. Unpack archive.
   $ tar -xvzf Flashphoner-1.0.x.xxx-p.yyy.tar.gz
3. Give permission to run
   $ chmod +x patch.sh
4. Run patch.sh. This script will copy all patched libraries into the WowzaMediaServer/lib folder.
   $ ./patch.sh
5. Restart Wowza Media Server
   $ /etc/init.d/WowzaMediaServer stop
   $ /etc/init.d/WowzaMediaServer start

Uninstall

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

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

You can uninstall Flashphoner using such commands:

$cd /usr/local/WowzaMediaServer/bin
$./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:

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/WowzaMediaServer/conf/flashphoner.serverid

There is known problem with serverId generation on some VPS.
This problem can be solved with patch Flashphoner-1.0.5.973-1040 and higher.

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. Download and install Flashphoner-1.0.5.973-1040 patch (if you version is older than 1040).
4. Restart server and make one call.

ServerId should be generated. See serverId file.