Contents

1   Description

This instruction describes how to import a backup from an external storage system or from a local storage location.

Import is used to make a backup locally available on the Managed Element (ME) after the backup has previously been exported and deleted from the ME. Import can be done before a coming backup restore operation or as preventive maintenance to ensure that important backups are locally available.

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

Note:  

Avoid importing a non-locally exported backup, as it results in a restore failure. If a backup created on another system must be imported for disaster recovery reasons, please contact Ericsson support for further instructions.

2   Procedure

2.1   Import 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 import is known.
  • If importing from an external storage location, the SFTP Uniform Resource Identifier (URI) of where the backup is to be imported from 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>/<backup_file_name>

  • If importing from 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/<backup_file_name>

  • 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. Start the import operation. A backup can be imported from a remote server or a local directory.
   • To import from a remote server, for example:

     (BrmBackupManager=SYSTEM_DATA)>importBackup --uri "sftp://hostuser1@host1/home/hostuser1/PERF_BACKUP_NAME1_20140428_175907.tar.gz" --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.
     • PERF_BACKUP_NAME1_20140428_175907.tar.gz is an example of the filename of the backup.
     • 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 import from a local file directory, for example:

     (BrmBackupManager=SYSTEM_DATA)>importBackup --uri "file:///BackupAndRestoreManagementFiles/BACKUP_NAME1_20140428_175907.tar.gz"

     Where:

     • BackupAndRestoreManagementFiles is the local directory where the backup was exported. Backups can be exported to a subfolder under the BackupAndRestoreManagementFiles folder.
     • BACKUP_NAME1_20140428_175907.tar.gz is an example of the filename of the backup.

   The system returns output true when the process starts.

   Note:  

   • BRM supports the import of files with GZIP and TAR formats.
   • To cancel the import of a backup, type cancelCurrentAction.

   
   
3. Verify that the backup is imported.

   (BrmBackupManager=SYSTEM_DATA)>show progressReport

   Note:  

   As 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 imported, the following shows an example of the progress report:

   [...] actionName="IMPORT" additionalInfo="Import Backup for PERF_BACKUP_NAME1_20140428_175907:⇒ Succeeded" progressInfo="" progressPercentage=100 result=SUCCESS resultInfo="PERF_BACKUP_NAME1_20140428_175907 was imported ⇒ 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 import, use action cancelCurrentAction.

   The name of the imported backup is listed at the end of the progress report along with other available backups. For more information on the progress report, refer to View Progress Report.