gxinstallmove

Description

Gxinstallmove is a UNIX client utility to perform backup and restore of an installed SnapProtect instance.

Usage

The utility allows the user to move the QiNetix configuration information (registry, software install folder, services, etc.) to a selected destination and restore it. This provides the facility to switch the computer between two or more CommServes, if needed. The QiNetix configuration is referred to as the QiNetix instance in this readme.

For example:

  1. Install Qinetix on client ticktock, using CommServe 1.
  2. Using gxinstallmove, back up the Qinetix instance to directory 1.
  3. Install the second instance of Qinetix (new version or same version) on ticktock, this time using CommServe 2.
  4. Back up the second instance with gxinstallmove, this time to directory 2.

    At this point there is no instance of Qinetix installed on ticktock, all files associated with the instance have been backed up. However, within a very short period you could restore Qinetix instance 1 or 2 (but not both) and be connected to its CommServe computer, as originally installed.

Before You Begin

  • Make sure that there are currently no jobs on the computer (either MediaAgent or Client).
  • In the case of the MediaAgent, the IndexCache will not be moved by this utility. Hence, do not remove this folder even after moving the QiNetix instance.
  • Do not overwrite the media that is used by the QiNetix instance that is being moved.
  • Do not move or delete the magnetic mount paths that are being used by the QiNetix instance that is being moved.
  • If necessary, note the destination folder. You may need this when you restore the QiNetix instance.
  • Do not Deconfigure this Computer from the CommServe.
  • This utility is not supported on a clustered environment.

Back Up an Instance

  1. Prepare a directory for backup destination.
  2. Run as root the following command: gxinstallmove -backup destination directory.

Restore an Instance

  1. Identify the directory previously backed up as the source directory.
  2. Run as root the following command: gxinstallmove -restore source directory.

Examples

Backup

# ./gxinstallmove -backup /gx1
Preparing for the backup

.....

Stopping Galaxy services ... done.
Verifying CommServe connectivity... done.
Checking for running jobs ... done.

.....

We are now ready to backup the Galaxy instance.

Press ENTER to begin ...

Backing up directory /etc/CommVaultRegistry... Done.
Checking directory /gx1/CommVaultRegistry... OK
Backing up directory /opt/galaxy... Done.
Checking directory /gx1/galaxy... OK
Backing up directory /opt/galaxy/iDataAgent/jobResults... Done.
Checking directory /gx1/jobResults... OK
Backing up directory /var/log/galaxy/Log_Files... Done.
Checking directory /gx1/Log_Files... OK
Backing up file /etc/Galaxy.pkg... Done.
Checking file /gx1/Galaxy.pkg... OK
Backing up file /etc/rc.d/rc3.d/S99Galaxy... Done.
Checking file /gx1/S99Galaxy... OK
Backing up file /etc/rc.d/rc3.d/K99Galaxy... Done.
Checking file /gx1/K99Galaxy... OK
Backing up file /etc/rc.d/rc5.d/S99Galaxy... Done.
Checking file /gx1/S99Galaxy... OK
Backing up file /etc/rc.d/rc5.d/K99Galaxy... Done.
Checking file /gx1/K99Galaxy... OK Removing instance... Done.

Successful completion of the backup of the Galaxy instance.

Thank you for using CommVault Systems Galaxy.

Restore

# ./gxinstallmove -restore /gx2
Preparing for the restore ...

.....

Press ENTER to begin ...

Description of Utility

gxinstallmove is a unix client utility to perform backup and restore of a installed Galaxy instance.

.....

Checking Galaxy instance source and destination...

Checking directory CommVaultRegistry...
source=/gx1/CommVaultRegistry... OK
destination=/etc/CommVaultRegistry... OK
Checking directory galaxy...
source=/gx1/galaxy... OK
destination=/opt/galaxy... OK
Checking directory jobResults...
source=/gx1/jobResults... OK
destination=/opt/galaxy/iDataAgent/jobResults... OK
Checking directory Log_Files...
source=/gx1/Log_Files... OK
destination=/var/log/galaxy/Log_Files... OK
Checking file Galaxy.pkg...
source=/gx1/Galaxy.pkg... OK
destination=/etc/Galaxy.pkg... OK
Checking file S99Galaxy...
source=/gx1/S99Galaxy... OK
destination=/etc/rc.d/rc3.d/S99Galaxy... OK
Checking file K99Galaxy...
source=/gx1/K99Galaxy... OK
destination=/etc/rc.d/rc3.d/K99Galaxy... OK
Checking file S99Galaxy...
source=/gx1/S99Galaxy... OK
destination=/etc/rc.d/rc5.d/S99Galaxy... OK
Checking file K99Galaxy...
source=/gx1/K99Galaxy... OK
destination=/etc/rc.d/rc5.d/K99Galaxy... OK
Checking file cvpkgrm...
source=/gx1/galaxy/cvpkgrm... OK
destination=/usr/bin/cvpkgrm... OK
Checking file cvpkgrm...
source=/gx1/galaxy/cvpkgrm... OK
destination=/usr/sbin/cvpkgrm... OK
Checking file cvpkgcheck...
source=/gx1/galaxy/cvpkgcheck... OK
destination=/usr/bin/cvpkgcheck... OK
Checking file cvpkgcheck...
source=/gx1/galaxy/cvpkgcheck... OK
destination=/usr/sbin/cvpkgcheck... OK
Checking file Galaxy...
source=/gx1/galaxy/Base/Galaxy... OK
destination=/usr/bin/Galaxy... OK
Checking file GxCmd...
source=/gx1/galaxy/Base/GxCmd... OK
destination=/usr/bin/GxCmd... OK

Congratulations! All the test passed.

We are now ready to restore the Galaxy instance.

Press ENTER to begin ...

Please wait while we restore the Galaxy instance...

Restoring directory /etc/CommVaultRegistry... Done.
Restoring directory /opt/galaxy... Done.
Restoring directory /opt/galaxy/iDataAgent/jobResults... Done.
Restoring directory /var/log/galaxy/Log_Files... Done.
Restoring file /etc/Galaxy.pkg... Done.
Restoring file /etc/rc.d/rc3.d/S99Galaxy... Done.
Restoring file /etc/rc.d/rc3.d/K99Galaxy... Done.
Restoring file /etc/rc.d/rc5.d/S99Galaxy... Done.
Restoring file /etc/rc.d/rc5.d/K99Galaxy... Done.
Recovering file /usr/bin/cvpkgrm... Done.
Recovering file /usr/sbin/cvpkgrm... Done.
Recovering file /usr/bin/cvpkgcheck... Done.
Recovering file /usr/sbin/cvpkgcheck... Done.
Recovering file /usr/bin/Galaxy... Done.
Recovering file /usr/bin/GxCmd... Done.

Starting Galaxy services ...

Successful completion of the restore of the Galaxy instance.

Thank you for using CommVault Systems Galaxy.