Skip to main content

Upgrading Ant Media Server

This guide explains how to upgrade the Ant Media Server from an earlier version to the latest version.

  • There are two ways to upgrade your Ant Media Server to the latest edition.

  1. Using the upgrade.sh script that automatically gets the latest version of the Ant Media Server and makes the upgrade. This script is available under the usr/local/antmedia directory by default for Ant Media Server version 2.9.0 and above.

  2. Using the install_ant-media-server.sh script and manually passing the Ant Media Server installation zip file.

Upgrading with the upgrade.sh script​

info

This script is available under the installation directory for Ant Media Server version 2.9.0 and above. If you want to use the script with an older version, kindly get the script from here

1. SSH into your Ant Media Server instance.

2. Navigate to the installation Directory.

cd /usr/local/antmedia

3. Run the upgrade script to start the upgrade process.

sudo ./upgrade.sh

4. The script will guide you through the process. It will:

  • Check the current version of Ant Media Server.

  • Compare it with the latest available version.

  • Download and install the new version if an update is needed.

  • After the script completes, verify that the Ant Media Server has been updated successfully.

unzip -p /usr/local/antmedia/ant-media-server.jar | grep -a "Implementation-Version"

This command will show the version of the installed Ant Media Server.

  • The script automatically determines whether you are using the Community or Enterprise edition of the Ant Media Server and makes the upgrade according to it. Therefore, the script can be used for both Community and Enterprise editions.

  • To learn more about the upgrade.sh script, please check here.

Upgrading with the Installation Script​

Another way to upgrade the Ant Media Server is by using the install_ant-media-server.sh

To use this approach, it is important to have the Ant Media Server installation zip file.

  • If you have purchased a license from Ant Media, then in the downloads section of your antmedia.io account, you can download the most recent version zip file.

  • In the case of Ant Media Server's Marketplace image on AWS, Azure, GCP, and Oracle Cloud, you can send an email to contact@antmedia.io and ask for the new version zip file.

  • In the case of Ant Media Server Community Edition, you can download the latest version zip file from here.

After downloading the zip file, kindly follow the below steps:

1. SSH into your Ant Media Server instance.

2. Download the installation script

Download theinstall_ant-media-server.sh shell script with the latest changes.

wget -O install_ant-media-server.sh https://raw.githubusercontent.com/ant-media/Scripts/master/install_ant-media-server.sh && sudo chmod 755 install_ant-media-server.sh

3. Run the installation script to upgrade the server

If you want to keep the settings from the previous installation, you must add the "-r true" flag at the end of the command.

sudo ./install_ant-media-server.sh -i <ANT_MEDIA_SERVER_ZIP_FILE> -r true

For change/release logs of the new version, please check here.

How do I restore the Ant Media Server if needed?​

Last but not least, when you make a fresh installation or upgrade over an older version, the previous installation will be backed up in the /usr/local directory with a timestamp value like antmedia-backup-2022-11-18_15-42-54.

To restore the previous installation, kindly follow the below commands:

sudo systemctl stop antmedia
sudo rm -rf /usr/local/antmedia
sudo cp -p -R /usr/local/antmedia-backup_folder/ /usr/local/antmedia
sudo chown -R antmedia:antmedia /usr/local/antmedia/
sudo systemctl start antmedia