This article from InSource shows...
- Author: Frank Ross
- Published: 12/29/2021
- Applies to: Aveva Application Server (System Platform) - All Versions
- Graphics used for this tech note taken from a node running Windows Server 2019 using Aveva System Platform 2020 Release 2 Patch 1.
This article describes two independent functions:
1. Backing up an Aveva Global Repository - The purpose of backing up a galaxy is to establish a recovery file in the event the primary galaxy has been corrupted or lost. This function is also necessary when upgrading the galaxy to a newer software version for system platform.
2. Restoring a backed up Global Repository - The purpose of restoring a galaxy file is either to recover from a lost or corrupted primary galaxy, or to use as a base file for upgrading to a newer software version for system platform.
The backup and restore process create and use a cabinet formatted file, i.e., CAB file. The cabinet file is a single file that uses a .cab extension in the file name and which stores compressed files in a file library.
Backup Process (step-by-step):
Warning: Before executing the backup procedure, make sure there are no open sessions using the Aveva IDE galaxy editor. The person peforming the backup procedure should have exclusive access to the galaxy repository until the backup has completed.
1. On the computer node hosting the Galaxy Repository, launch the Aveva System Platform Management Console
2. Locate the Galaxy Database Manager and expand the tree view to show the list of galaxies:
3. Right-click on the galaxy name you wish to execute the backup procedure, and select the Backup menu item:
Note: A warning message will be displayed advising that no edits will be permitted during the backup execution process. Click on the Yes button to continue the backup process.
4. The procedure will then prompt for a name and location to store the backed up .cab file. It is recommended to establish a backup naming convention and storage location for the galaxy backup files. In this example, the galaxy name has been suffixed with the date of the backup. Also notice the file folder called Galaxy Repository Backups, which is being used to store all backup galaxy files. Select the appropriate folder and then click on the Save button.
Note: For additional recovery capability, it is recommended to copy the backed up galaxy file to another node. Assuming the galaxy node is being backed up on a daily basis from IT Support, but if not, having an off-node copy of the galaxy file provides added recovery capability should something happen to the hard drive on the galaxy repository node.
5. The Backup process will now execute thus backing up the galaxy. Note, this process is likely to take several minutes to complete, based on the size of the galaxy. When the backup has completed, click on the Close button. After clicking on the Close button, the procedure to back up the galaxy has now been successfully completed. You can now exit the System Managemet Platform Console.
Galaxy Backup In Progress
Galaxy Backup Completed
The backup process is now complete.
Restore Process (step-by-step):
1. Copy the target galaxy repository cab file to folder location C:\Program Files (x86)\ArchestrA\Framework\Bin\BackupGalaxies. This file would have been previously backed up prior to executing the restore process.
2. Launch the Aveva System Platform IDE software:
3. Click on the New Galaxy... button to create a new galaxy repository:
4. The procedure will now prompt for a new Galaxy Name and type of galaxy. Make sure you select the backed up galaxy from the drop down list in the Galaxy Type combo box. Enter a new name for your galaxy. Note: make sure you provide a unique name for your new galaxy or the system will not create the new galaxy. Once this information is provided, click on the Create button to initiate the process:
The creation of the new galaxy will take a few minutes to build. Once finished, the system will provide a completed window with a status.
Upon successful completion, the new galaxy has now been created. To access it, simply launch the System Platform IDE and select the new galaxy. Note: all galaxy objects will be in an undeployed state.
The restore process is now complete.