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 there, 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 launch.
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 flashphoner.properties file and restart WCS
3. 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 updating from 5.2 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 updating from 5.2 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