Contents

1   Description

This instruction describes how to export a backup to an external storage system or local file 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 syntax of the backup filename is one of the following:

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

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.

2   Procedure

2.1   Export Backup

Prerequisites

• No documents are required.
• No tools are required.
• The following condition must apply:
  • This feature requires that the LDE-BRF-SCRIPT or another storage owner participant that supports this feature is installed.
  • This feature requires Export Import Agent (EIA) with support for protocol to be used for transfer, for example, SFTP or File Management (FileM).
  • No other backup operation is in progress.
  • The backup type is known.
  • The name of the backup to export is known.
  • If exporting to an external storage location, the SFTP Uniform Resource Identifier (URI) of where the backup is to be exported is known. If the SFTP URI requires a password, the password is known.

    The format of the SFTP URI is as follows: sftp://<user_id>@<hostname_or_IP_address>/<remote_destination_directory>

  • If exporting to a local storage location using the FileM protocol, the backup folder is known. By default, Backup and Restore Management (BRM) creates the BackupAndRestoreManagementFiles folder to store local backups. It is possible to create subfolders within BackupAndRestoreManagementFiles.

    The format of the FileM URI is as follows: file:///BackupAndRestoreManagementFiles

  • An Ericsson Command-Line Interface (ECLI) session in Exec mode is in progress.

Steps

1. Navigate to the BrmBackupManager managed object, for example:

   >dn ManagedElement=NODE06ST,SystemFunctions=1,BrM=1,BrmBackupManager=SYSTEM_DATA

2. List the available backups:

   (BrmBackupManager=SYSTEM_DATA)>show

   The following is an example output:

   BrmBackup=PERF_BACKUP_NAME1_20140428_175907 BrmBackup=PERF_BACKUP_NAME1_20140501_100533 BrmBackup=PERF_BACKUP_NAME1_20140501_100926 BrmBackup=PERF_BACKUP_NAME1_20140501_101310 BrmBackup=PERF_BACKUP_NAME1_20140501_102102 BrmBackup=PERF_BACKUP_NAME1_20140501_102500

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

   (BrmBackupManager=SYSTEM_DATA)>BrmBackup=PERF_BACKUP_NAME1_20140501_102500

5. Start the export operation. A backup can be exported to a remote server or to a local directory.
   • To export to a remote server:

     (BrmBackup=PERF_BACKUP_NAME1_20140501_102500)>export --uri "sftp://hostuser1@host1/home/hostuser1/" --password "hostuser1pw"

     Where:

     • hostuser1@host1 is the <user_id>@<hostname_or_IP_address> of the remote server.
     • The <hostname_or_IP_address> must be enclosed by [ ] for IPv6.
     • /home/hostuser1/ is the remote destination directory of the remote server.
     • hostuser1pw is the password of the remote server. This password is optional. If a password is not required to access the URI, leave out the --password parameter.
   • To export to a local file directory:

     (BrmBackup=PERF_BACKUP_NAME1_20140501_102500)>export --uri "file:///BackupAndRestoreManagementFiles"

     Where BackupAndRestoreManagementFiles is the local directory. Subfolders can be created under the BackupAndRestoreManagementFiles folder.

   The system returns output true when the process starts.

   Note:  

   To cancel the export of a backup, type cancelCurrentAction.

   
   
6. Verify that the backup is exported:

   (BrmBackup=PERF_BACKUP_NAME1_20140501_102500)>show progressReport

   Note:  

   As this is a long-running operation, it can be necessary 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 PERF_BACKUP_NAME1_20140428_175907:⇒ Succeeded" progressInfo="" progressPercentage=100 result=SUCCESS resultInfo="PERF_BACKUP_NAME1_20140428_175907 was exported ⇒ successfully state=FINISHED [...]

   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.