Backup Commands

The Oracle Communications Session Border Controller includes a set of commands for easily working with backup configurations. These commands are backup-config, display-backups, delete-backup-config, restore-backup-config.

Oracle suggests that you back up properly functioning configurations on your system before making any new major configuration changes. The backup configurations are crucial to have when configuration changes do not function as anticipated and a rollback must be applied immediately.

To back up the system configuration, use the backup-config command. You can confirm your backup has been created with the display-backups command. When the backup-config command is executed, the system checks if sufficient resources exist to complete the operation. If resources are sufficient, the system creates the backup. If resources are insufficient, the task is not completed and the Oracle Communications Session Border Controller instead displays the limiting resources, recommending that the task be completed at another time.

Backups are created as gzipped files in a .gz format. They are stored in the /code/bkups directory on the Oracle Communications Session Border Controller.

Creating Backups

To create a backup :

In the ACLI at the superuser prompt, enter the backup-config <filename> [editing | running] command. Enter backup-config followed by a descriptive filename for the backup you are creating. You can also enter an optional argument to specify whether you want to create a backup from the editing configuration cache or the running configuration cache.
```
ORACLE# backup-config 01_Feb_2005_Test running
task done
ORACLE#
```

Listing Backups

To list available backup configurations:

In the ACLI at the superuser prompt, enter the display-backups command. A list of available backup files from the /code/bkups directory is displayed on the screen.
```
ORACLE# display-backups
test_config.gz
test-config.gz
runningcfgtest.gz
runningtest_one.gz
BACK_UP_CONFIG.gz
02_Feb_2005.gz
01_Feb_2005_Test.gz
ORACLE#
```

Restoring Backups

To restore a backup configuration:

In the ACLI at the superuser prompt, enter the restore-backup-config <filename> [running | saved] command. Enter restore-backup-config followed by the backup filename you wish to restore to the current configuration. You must explicitly name the backup file you wish to restore, including the file extension. You can also enter an optional argument to specify whether you want to restore the last running configuration or the last saved configuration on the Oracle Communications Session Border Controller.
```
ORACLE# restore-backup-config backup_file.gz saved
Need to perform save-config and activate/reboot activate for changes to take effect...
task done
ORACLE#
```
You can restore files from either .tar.gz format or just .gz. All backup files are gzipped in the .gz format.

You must still save and activate the configuration or reboot the Oracle Communications Session Border Controller to apply the backup configuration.

Deleting Backups

The delete-backup-config command deletes the backup configurations from the /code/bkups directory on your system.

In the ACLI at the superuser prompt, enter the delete-backup-config command, followed by the backup file you wish to delete.
```
ORACLE# delete-backup-config FEB_BACKUP.gz
task done
ORACLE#
```

Viewing Backup Configurations

The show backup-config command displays a specified configuration file saved on the Oracle Communications Session Border Controller's standard backup file directory.

In the ACLI at the superuser prompt, enter the show backup-config command followed by the backup configuration filename you want to view.
```
ORACLE# show backup-config 
```
The configuration of the backup file you specify is displayed on the screen. The contents of this output are in the same format as the show configuration command. For example:
```
ORACLE# show backup-config
Possible configuration files are:
0606_HMRSIPNAT_Overlay.gz
0606_HMRSIPPeering.gz
0605_SingleSIPNATH_in_access.gz
0605_SingleSIPNATHTN_ABBN.gz
0605_SNB_ABBN.gz
HMR_OAI_config.gz
0619_HMR_OAI.gz
```