/

Server Upgrade Instructions


How to Upgrade Red5 Pro Server

The process for upgrading your Red5 Pro server is pretty straightforward.

Assuming that you set up your server per installing Red5 Pro server on linux, there are just a few basic steps needed to update your server.

  • Copy the new Red5 Pro Server Distribution to your server. If you are using FTP, you will probably need to copy this up to the /tmp/ directory.
  • Move the zip file to the same directory as your current installation (for example, /usr/local/), and unzip it. Important: DO NOT unzip the new distribution into the same directory that the original server is running in.
  • If you have your own web applications in the folder red5pro/webapps/ you can copy it from your current Red5 Pro directory to the new one.
  • If you have modified any configuration files, then make the same edits in the new distribution's configuration files. Important: DO NOT copy configuration files from old build to the new one.
  • The following files are the most likely candidates to have been modified:

    • for SSL, {red5pro}/conf/red5.properties and {red5pro}/conf/jee-container.xml
    • for FLV conversion to MP4 and S3 file storage, {red5pro}/conf/red5-common.xml, {red5pro}/webapps/live/WEB-INF/red5-web.xml, and {red5pro}/conf/cloudstorage-plugin.properties
    • for server API, {red5pro}/webapps/api/WEB-INF/red5-web.properties, {red5pro}/webapps/api/WEB-INF/security/hosts.txt
    • for Simple Auth Plugin, {red5pro}/conf/simple-auth-plugin.properties and {red5pro}/conf/simple-auth-plugin.credentials
    • for Clustering, {red5pro}/conf/cluster.xml
    • for HLS modification, {red5pro}/conf/hlsconfig.xml
    • for WebRTC modification, {red5pro}/conf/webrtc-plugin.properties
    • for Restreamer, {red5pro}/webapps/live/WEB-INF/web.xml
    • for SRT, {red5pro}/conf/restreamer-plugin.properties
  • Stop the red5pro service (sudo systemctl stop red5pro - or sudo ./red5-shutdown.sh if you are not running Red5 Pro as a service). Note: it can take up to 30 seconds for the server to fully shut down.
  • Rename (or delete) the old server directory.
  • Rename the new server directory to the original folder name (e.g., red5pro).
  • Copy the new red5pro.service file: cp /usr/local/red5pro/red5pro.service /lib/systemd/system/
  • Reload the daemon: systemctl daemon-reload
  • Start the red5pro service (sudo systemctl start red5pro start or sudo ./red5.sh & if you are not running Red5 Pro as a service).
  • Verify your server is running by navigating to http://< your server ip >:5080. You can verify you are running the new release by the version number listed in the top-left corner of the screen.

Upgrade Red5 Pro on Windows

If you are running Red5 Pro on Windows, it's essentially the same process as above. Move the zip file to the same directory as your current installation (for example, C:\Program Files), and unzip it. Copy any custom web applications, and modify any configuration files in the new server distribution that you modified in the original one. Important: DO NOT unzip the new distribution into the same directory that the original server is running in.