Contents

1   Introduction

This document describes how to export a backup to an external storage system.

Export is used to store the important Managed Element (ME) backups in a safe place. It therefore limits the impact of unintentional local deletion of backup files on the ME. Export can indirectly be used to free up space on the ME since all exported backups are not always needed to be present locally on the ME.

A backup can be exported for System Data or User Data.

The format of the filename is one of the following:

• <prefix_label>_<backup_name>_SYSTEM_<YYYYMMDD>_<hhmmss>.tar
• <prefix_label>_<backup_name>_USER_<YYYYMMDD>_<hhmmss>.tar

Note:  

A prefix for the label that is generated for all backup export packages can be specified. For more information, refer to Change Prefix for Exported Backup Names.

1.1   Prerequisites

This section describes the prerequisites, which must be fulfilled before using the procedure.

1.1.1   Conditions

The following conditions must apply:

• No other backup operation is in progress.
• The backup type is known.
• The name of the backup to export is known.
• The Uniform Resource Identifier (URI) of where the backup is to be exported is known.
• If the URI requires a password, the password is known.
• An Ericsson Command-Line Interface (ECLI) session in Exec mode is in progress.

2   Procedure

To export a backup:

1. Navigate to the BrmBackupManager Managed Object (MO), for example:

   >dn ManagedElement=<Node Name>,SystemFunctions=1,BrM=1,BrmBackupManager=USER_DATA

2. List the available backups:

   (BrmBackupManager=USER_DATA)>show

   The following is an example output:

   BrmBackup=NDB_Sche_Calendar_Event_2015-06-17T09-04-13 BrmBackup=testBackup_20150617

3. Identify the backup to export.
4. Navigate to the appropriate BrmBackup MO, for example:

   (BrmBackupManager=USER_DATA)>BrmBackup=testBackup_20150617

5. Start the export operation.

   (BrmBackup=testBackup_20150617)>export --uri "sftp://<host_user>@<host_address>/<path_on_host_for_backup>" --password "<password_of_host_user>"

   For example:

   (BrmBackup=testBackup_20150617)>export --uri "sftp://root@192.168.2.3/tmp/" --password "root000"

   Note:  

   The password is optional. If a password is not required to access the URI, enter an empty string ("").

   
   

   The system returns output true when the process starts.

6. Verify that the backup is exported:

   (BrmBackup=testBackup_20150617)>show -v

   Note:  

   Since this is a long-running operation, it can be required to enter the command several times until the final operation result is shown in the progress report.

   
   

   After a backup is successfully exported, the following shows an example of the progress report:

actionName="EXPORT"
      additionalInfo
         "Export Backup for testBackup_20150617: Succeeded"
      progressInfo=""
      progressPercentage=100
      result=SUCCESS
      resultInfo="testBackup_20150617 was exported successfully."
      state=FINISHED
      timeActionCompleted="2015-06-17T18:32:09"
      timeActionStarted="2015-06-17T18:32:02"
      timeOfLastStatusUpdate="2015-06-17T18:32:09"

If an error occurs during the execution of the operation, the progress report shows result=FAILURE and additionalInfo shows the cause of the failure. The cause can be an invalid URI, a password error, backup integrity issues, or communication issues.

To cancel the ongoing backup export, use action cancelCurrentAction.

For more information on the progress report, refer to View Progress Report.