Document toolboxDocument toolbox

(12.05.100-en) Creating a Backup of the IGEL UMS

The following article explains how you can create a backup of your IGEL Universal Management Suite (UMS) installation.


Menu path: UMS Administrator > Backups

Default path to the UMS Administrator:

Linux: /opt/IGEL/RemoteManager/RMAdmin.sh
Windows: C:\Program Files\IGEL\RemoteManager\rmadmin\RMAdmin.exe

The IGEL UMS Administrator application can only be started on the UMS Server.



Embedded Database

To create a backup of the UMS installation with the embedded database, proceed as follows:

  1. Open the UMS Administrator and select Backups.

  2. Click Change to change the storage location for your backups.

  3. Click Create.

  4. Under Backup name, enter a name for the backup.

  5. Select the backup settings under Choose backup settings:
    The following can be selected:

    • Select all (Default): Database, server configurations, and transfer files (normally, you’ll use this option to ensure that no components are missing from the backup)

    • Embedded Database: Database

    • All files: Transfer files (e.g. images, session certificates, etc.)
      Note that files which have not been registered in the UMS, but are only stored in the system web resources (e.g. were manually placed in the folder ums_filetransfer) are NOT backed up by the UMS Administrator.

    • Custom: You can select the data which are to be backed up.

      image-20240618-125442.png

       

Universal Firmware Updates

The files of firmware updates are not part of the UMS embedded DB backup. They are not included in the Transfer files backup, and, therefore, have to be copied manually from [IGEL installation directory]/rmguiserver/webapps/ums_filetransfer.

 

  1. Confirm your selection by clicking on OK.
    The data will be saved in the directory you have selected.

    Remember to back up also the UMS ID, see UMS ID Backup in the IGEL Administrator.

External Database

The full range of backup options in the UMS Administrator is only available if you use the embedded database for your UMS Server installation.

If you use an external database, proceed as follows to make a complete backup of your system:

  1. For the database itself, use the backup and recovery procedures recommended by the DBMS manufacturer.

 

 

  1. Back up server configurations with the UMS Administrator > Backups > Create > Custom > Server configurations. Note separately host-specific configurations that differ from the defaults, see above Server configurations:

    image-20240618-130707.png



  2. Files and firmware updates must be backed up separately, i.e. manually copied to a secure storage medium. You can find them here: 

[IGEL installation directory]/rmguiserver/webapps/ums_filetransfer

 

  1. Back up also the UMS ID, see UMS ID Backup in the IGEL Administrator.

 

  1. For HA installations only: Save the current IGEL network token (allows the integration of new servers into the same HA network). This is usually a token created during the installation, see Installing the First Server in an HA Network. If a new IGEL network token has been generated in the meantime, e.g. if changes to certificates were made (see "High Availability" under Device Communication Certificates in the IGEL UMS), this is the token to be backed up.