WCS update to 5.2¶

What's new in WCS 5.2 compared with WCS 5.1¶

WCS manager module is removed, its functions is moved to WCS Core
Server startup is significally accelerated to a few seconds
Monitoring functions are moved to dedicated application

What's new in WCS 5.1 compared with WCS 5.0¶

Added SIP calls, streams and system state basic realtime monitoring, with the ability to view calls and streams history.
SIP core rewritten.
Added audio and video streams mixer.
Added stream recording on demand (to record mixed stream for example).
Added streams published in chat room recording with record files merging ability.
Added RTMP stream pulling.
Added REST API methods to manage new functions.

New version installation with previous version update¶

Updating 5.1 to 5.2 or one 5.2 build to another¶

To update WCS 5.1 or 5.2 on your server to latest WCS 5.2 build, you have to do the following steps:

1. Download WebCallServer installation package from this page, for example:

wget https://flashphoner.com/downloads/builds/WCS/5.2/FlashphonerWebCallServer-5.2.XXXX.tar.gz

2. Unpack the package

tar -xvzf FlashphonerWebCallServer-5.2.XXXX.tar.gz

3. Stop WCS

sudo systemctl stop webcallserver

4. Launch WCS 5.2 installation script

cd FlashphonerWebCallServer-5.2.XXXX
sudo ./install.sh

5. When the installation script finishes, update the service startup information

sudo systemctl daemon-reload

6. Start WCS

sudo systemctl start webcallserver

Check how server works by this instruction.

Since build 5.2.574, scripts in the /usr/local/FlashphonerWebCallServer/bin folder will not be overwritten to preserve possible tweaks while updating from one 5.2 build to another.

Updating 5.0 to 5.2¶

Before updating to 5.2, WCS 5.0 should be updated to latest 5.1 by this manual.

Another WCS version installation without previous version removing or updating¶

Sometimes, it is necessary to install more recent or older WCS version without removing or updating the already installed one. This can be done as follows:

1. Stop WCS

sudo systemctl start webcallserver

2. Remove symbolic link to WCS directory

cd /usr/local
sudo rm -f FlashphonerWebCallServer

3. Install the desired version and activate it with your license number.

4. Launch the newly installed WCS version

sudo systemctl start webcallserver

Switching between two WCS installations¶

Suppose there are two versions installed on the server: 5.0.3333 and 5.1.3356. To switch from 5.1.3356 to 5.0.3333 do the following steps:

1. Stop WCS 5.1.3356

sudo systemctl stop webcallserver

2. Remove symbolic link to WCS directory

cd /usr/local
sudo rm -f FlashphonerWebCallServer

3. Make symbolic link to the desired version directory

cd /usr/local
sudo ln -sf FlashphonerWebCallServer-5.0.3333 FlashphonerWebCallServer

4. Launch WCS 5.0.3333

sudo systemctl start webcallserver

Switching back is done same way.

Known issues¶

1. update.sh script does not start¶

Symptoms

"Permission denied" message on update.sh launch.

Solution

Set permissions to execute update.sh script

cd FlashphonerWebCallServer-5.1.3375/server/tools
chmod +x update.sh
./update.sh

2. Secure Websocket connections are failed after server update¶

Symptoms

Two Way Streaming example and other stream publishing and playing examples does not work

Solution

Remove the string

wss.keystore.file=wss.jks

from /usr/local/FlashphonerWebCallServer/conf/flashphoner.properties file and restart WCS

3. Two WCS instances should not be run simultaneously¶

When two WCS versions are installed on same server, those instances should not be running simultaneously

4. WCS cannot start due to permission lack after update¶

WCS may not start due to permission lack after updating from a previous build to 5.2.976 or newer

Symptoms

WCS is not starting with the following message

FlashphonerWebCallServer cannot be started from user flashphoner, please fix the permissions to the folders or run 'webcallserver set-permissions'!

Solution

Use the following command

sudo /usr/local/FlashphonerWebCallServer/bin/webcallserver set-permissions

then restart WCS

5. WCS cannot start due to service parameters changing after update¶

WCS may not start due to service parameters changing after updating from a previous build to 5.2.976 or newer

Symptoms

WCS is not starting with the following messages in /usr/local/FlashphonerWebCallServer/logs/startup.log file

[2021-07-05 09:02:12] INFO checkJavaOptions - Checking JVM options
sudo: unrecognized option '--show-version'
...
[2021-07-05 09:02:12] ERROR checkJavaOptions - FlashphonerWebCallServer can't start due to incorrect java options

Solution

Use the following command

sudo /usr/local/FlashphonerWebCallServer/bin/webcallserver fix-service

then restart WCS