How to correctly backup GCEMS files when upgrading IMG software versions

Introduction:   

When upgrading the Dialogic IMG Integrated Media Gateway (IMG)  software to a newer build it is recommended that you back up certain Dialogc® Gate Control Element Management System (GCEMS) directories in order to preserve any existing configuration and license files.

Due to the way IMG software works, all installs must be done as root; however, some of the files written to during the install need to have the permissions of the excelsw user.  

This article describes how to backup the correct files without overwriting any of the permissions set on the directories and at the same time compresses the backup so it take up less space.

Procedure: 

To correctly back up the correct files and directories before an upgrade you will need to do the following:

1. In GCEMS ClientView, select the configuration object.  On this object, click on the Query all tags and Refresh config buttons to update the configuration model within GCEMS

2. Also in ClientView, select File -> Save Configuration File. This will save a file with a .csa  suffix containing the system configuration with the same name as the Configuration object in ClientView.

Click on the following image to display it full-size

Open

3. Run the following commands to backup the configuration, license and appdata directories

tar -pcvzf config.tgz /opt/dialogic/common/config/*
tar -pcvzf license.tgz /opt/dialogic/common/license/*
tar -pcvzf appdata.tgz /opt/dialogic/common/appdata/*

The options for the tar command above are defined as follows:

p == preserve permissions
c == create archive
v == verbose (print names while making tar)
z == gzip
f == tar file name

In the list of commands the f must be the last command before the archive file name.

After the backup, move these files to a location other than /opt/dialogic (preferably to a backup server) as the new install will be placed in this location.

This will correctly back up the above directories if they are needed after the upgrade.

If the files are needed again

To uncompress a file use:

tar -pxvzf filename.tgz

The options for the tar command above are defined as follows:

p == preserve permissions
x == extract archive
v == verbose (print names while making tar)
z == unzip
f == tar file name

As with the tar command to compress the files the f must be the last command before the archive file name.

Product List:

Dialogic IMG Integrated Media Gateway

Dialogic Gate Control Element Management System (GCEMS)