When it's time to upgrade DDM there are a number of ways in which this can be done depending on the type of installation you have and the DDM version being used. This guide sets out to offer instructions and pre-requisites that should help to make an efficient process.
Key Notes
- Upgrading to DDM 1.7 requires a fresh install from a backup. Due to changes in the underline operating system from Centos to Rocky, it is not possible to upgrade DDM through the web interface.
- Upgrading to newer versions of DDM requires a backup from 1.1. Backups from 1.0 will not work on newer DDM systems.
Prior to Upgrading by Fresh Installing with a Backup
Please check the following list and ensure that all required items are prepared before you upgrade DDM. If you have DDM installed on a virtual machine, please read paragraph A, or if you have installed DDM on a physical machine, please read paragraph B:
Paragraph A (Virtual Machine):
o Download the DDM image https://www.audinate.com/latestddm
o Prepare a new virtual machine instance (3 instances if you have HA enabled) according to https://dev.audinate.com/GA/ddm/userguide/1.7/webhelp/content/installing_ddm.htm
o Ensure the virtual machine instance/ instances have an active Internet connection (for license activation). Access will be required on software-license-ddm.audinate.com port 443 for license activation.
o Save a copy of the System Configuration and System Logs (DDM web interface> Settings> Updates & System Information).
o If TLS is installed, keep a copy of your TLS Private Key and Certificate (DDM web interface> Settings> Network & Security).
o Make a note of the DDM IP address, subnet mask, DNS IP address, and gateway IP address (blue DDM Configuration Main Menu> Configure Interfaces). If HA is enabled, record the IP settings of all three nodes as well as the DDM virtual IP address.
o Make a note of FQDN (DDM web interface> Settings> Network & Security).
o Make a note of the DDM license ID (DDM web interface> Settings> License Management).
o Export a device list showing which devices are currently online. This gives you an idea of how many devices to expect to be back online after a DDM update. (DDM web interface> Devices> Export CSV).
o Have Site Admin access to DDM.
o Have admin access to the virtual machine host.
Paragraph B (Bare Metal Machine):
o Download the DDM image https://www.audinate.com/latestddm
o Create a bootable USB drive using a dedicated flashing tool such as https://etcher.balena.io/
o Ensure the physical host server (3 servers if you have HA enabled) meets the minimum requirements: https://dev.audinate.com/GA/ddm/userguide/1.7/webhelp/content/installing_ddm.htm
o Ensure the host/ hosts have an active Internet connection (for license activation). Access will be required on software-license-ddm.audinate.com port 443 for license activation.
o Save a copy of the System Configuration and System Logs (DDM web interface> Settings> Updates & System Information).
o Make a note of the DDM IP address, subnet mask, DNS IP address, and gateway IP address (blue DDM Configuration Main Menu> Configure Interfaces). If HA is enabled, record the IP settings of all three nodes as well as the DDM virtual IP address.
o Make a note of FQDN (DDM web interface> Settings> Network & Security).
o Make a note of the DDM license ID (DDM web interface> Settings> License Management).
o If TLS is installed, keep a copy of your TLS Private Key and Certificate (DDM web interface> Settings> Network & Security).
o Export a device list showing which devices are currently online. This gives you an idea of how many devices to expect to be back online after a DDM update. (DDM web interface> Devices> Export CSV).
o Have Site Admin access to DDM.
o Have admin access to the physical host server.
o Have admin access to the network switch, if you need specific network settings for servers.
Upgrading Through the Web GUI
DDM Fresh Install from a Backup
- Create a backup of the current configuration
Via the DDM web interface, save a copy of the current configuration from Settings > Update and System Information > System Configuration > Download. This will save a .tgz file to the computer and the following information is saved:
Domain names and credentials (domain credentials are shared between domains and devices to establish membership)
Device enrolment information
User and role information, including usernames, passwords (encrypted), role names, etc.
Dashboard alerts
External services configuration, (LDAP, SNMP).
Audit Log information
LDAP groups
High Availability configuration (NOT FORMED)
TLS upload
Refer to Updates and System Information Settings section in the Help for more information.
- Create a new virtual machine
You will need to obtain the latest DDM ISO from the Downloads page. On that same page, you will find multiple installation guides for various VM hypervisors and an installation which describes bare metal installation. Choose the guide that matches your environment and follow the instructions.
Note. You can create a new machine whilst the current system is still running.
- Configure IP settings within the VM’s settings
After the machine has finished installing, you’ll be presented with the Main Menu. Configure the virtual machines IP settings as required by selecting Configure Interfaces: - Enter your IP settings. Below is an example of a static IP configuration:
You should now be able to access the DDM web interface.
- Upload the Configuration to the Server
To access the DDM web interface, open a web browser and enter the IP address or name of DDM. The first step in the installation process will ask if you want to create a Fresh Installation or Restore a configuration. Choose Restore Configuration:
After selecting this option, you will be asked to upload the configuration, which is the backup saved from the other installation saved as a .tgz file.
- Locate the file by using the ‘Browse’ option, and then upload.Note: if you had a TLS certificate uploaded, you may need to refresh your browser at this point to proceed, as this will have transferred from the previous system.
At this point, you will be presented with the standard DDM login screen. Once logged in, you will need to activate the license from the previous system (requires access to https://software-license-ddm.audinate.com/). You can either do this manually by deactivating the license within the previous system and copying it across, or if you do not have access to the previous system contact Audinate Support, who can remotely deactivate the license.
Once licensed, the DDM web interface should appear with the saved configuration as before.