Cisco Billing and Measurements Server, Release 3.20 - Backing Up and Restoring BAMS [Cisco Billing and Measurements Server]

Table Of Contents

Backing Up and Restoring BAMS

Backup Utility

Restore Utility

Restoring a BAMS Release That Is the Same as the Current BAMS Release

Restoring a BAMS Release That Is Different from the Current BAMS Release

Backing Up and Restoring BAMS

Backup Utility

You can use the BAMS utility, bamsbackup, to back up the current configuration files and all executable files and intermediate files (that is, incompletely processed files in the /output directories and checkpoint files). You can also specify whether you wish to back up the billing files (BAMS output files and the archived CDR files from the PGW). You can specify whether the back up is to a regular file or a tape device.

Note Before you run the bamsbackup utility, check to ensure that the file ADMss is present in the directory /opt/CiscoBAMS/bin. The ADMss file must be present before you start this utility.
Format

bamsbackup [ -y ] [ -b | -n ] [ -f filename | -t device_name ]

Description

The value of -y is do not prompt user to confirm backup.

The value of -b is back up billing files.

The value of -n is do not back up billing files.

The value of -f filename is back up to regular file named filename.

The value of -t device_name is back up to tape device named device.

Note Only one of the -b/-n or -f/-t flags can be used in the same command.
Example
$ bamsbackup
-b or -n parameter must be specified to indicate whether billing files are to be backed up:
b) Back up billing files
n) Do not back up billing files
q) Quit
Enter selection (b,n,q): b
-f or -t parameter must be specified to indicate backup to file or tape device:
f) Backup to file
t) Backup to tape device
q) Quit
Enter selection (f,t,q): f
Enter backup filename: /tmp/bamsbackup.12252004.cpio
Backup filename specified: /tmp/bamsbackup.12252004.cpio
***********************************************************************
The program /opt/CiscoBAMS/bin/bamsbackup will archive the following to the file /tmp/bamsbackup.12252004.cpio:
1) Current BAMS configuration files
2) All BAMS executables
3) All BAMS intermediate files
4) All BAMS billing output files
Do you want to continue with bamsbackup (y/n)? y
/opt/CiscoBAMS/bin
/opt/CiscoBAMS/bin/ACC
/opt/CiscoBAMS/bin/ADMal
.
.
.
229280 blocks
Backup successful.
Program /opt/CiscoBAMS/bin/bamsbackup complete. All files archived to /tmp/bams
backup.12252004.cpio
Restore Utility

The bamsrestore utility restores BAMS Release 3.20 and later releases from any previously backed up files.

The restore utility prompts you to back up the current files and proceeds only after you confirm that you want to do so.

You can use the restore utility to restore files from a backup file or a tape device. The utility also provides you with an option to restore the billing output files.

Note Before you run the bamsrestore utility, check to ensure that the file ADMss is present in the directory /opt/CiscoBAMS/bin. The ADMss file must be present before you start this utility.
Format

bamsrestore [ -y ] [ -i | -k ] [ -b | -n ] [ -f filename | -t device_name ]

Description

The value of -y is confirm (that is, the user is not reminded to restore current files).

The value of -i is restore intermediate files (applicable only if you are restoring the same BAMS version).

The value of -k is keep intermediate files, do not restore intermediate files (applicable only if you are restoring the same BAMS version).

The value of -b is restore billing files.

The value of -n is do not restore billing files.

The value of -f filename is restore from regular file named filename.

The value of -t device_name is restore from tape device named device.

Note Only one of the -i/-k, -b/-n or -f/-t flags can be used on the command line. If the -y flag is not provided, the utility reminds you about backing up current files and prompts you to confirm that you wish to do so.
Example
$ bamsrestore
-b or -n parameter must be specified to determine whether billing files are restored:
b) Restore billing files
n) Do not restore billing files
q) Quit
Enter selection (b,n,q): b
-i or -k parameter must be specified to determine whether intermediate files are restored:
i) Restore intermediate files
k) Keep current intermediate files. Do not restore intermediate files q) Quit
Enter selection (i,k,q): k
-f or -t parameter must be specified to indicate restore from file or tape device:
f) Restore from file
t) Restore from tape device
q) Quit
Enter selection (f,t,q): f
Enter restore filename: /tmp/bamsbackup.12252004.cpio
Restore filename: /tmp/bamsbackup.12252004.cpio
Current BAMS Version = 3.20
/opt/CiscoBAMS/bin/ADMss
229280 blocks
BAMS restore VERSION = 3.20
Current BAMS Version 3.20 is the same as the restore version of 3.20.
***********************************************************************
The program /opt/CiscoBAMS/bin/bamsrestore will restore the following from the file /tmp/bamsbackup.12252004.cpio:
1) Current BAMS configuration files
2) All BAMS executables
3) All BAMS billing output files
* Current BAMS intermediate files will be kept. Intermediate files
* will not be restored from /tmp/bamsbackup.12252004.cpio
Before restoring from /tmp/bamsbackup.12252004.cpio, the current BAMS files should be backed up using the utility 'bamsbackup'.
Do you want to continue with bamsrestore (y/n)? y
Saving current intermediate files since restore from FILES_DIR will overwrite these
/opt/CiscoBAMS/files/s01/acc_checkpt
/opt/CiscoBAMS/files/s01/cor_checkpt
/opt/CiscoBAMS/files/s02/acc_checkpt
20 blocks
Restoring files from /tmp/bamsbackup.12252004.cpio ...229280 blocks
Restore successful.
Example (cont.)
Restoring current intermediate files since these were temporarily overwritten by the restore from FILES_DIR
/opt/CiscoBAMS/files/s01/acc_checkpt
/opt/CiscoBAMS/files/s01/cor_checkpt
.
.
.
20 blocks
For listing of files restored from /tmp/bamsbackup.12252004.cpio, see:
/tmp/bamsrestore.list.20041006143211
Program /opt/CiscoBAMS/bin/bamsrestore complete
Restoring a BAMS Release That Is the Same as the Current BAMS Release

The restore utility asks you whether you want to restore the intermediate files and billing files.

If you want to restore intermediate files, the restore utility removes the current intermediate files in the output directory and the checkpoint files, then restores intermediate files from the backup version.

If you do not want to restore intermediate files, then only executable and configuration files are restored. The current intermediate files are not touched.

Restoring a BAMS Release That Is Different from the Current BAMS Release

The restore utility removes the current intermediate files in the output directory and the checkpoint files, then restores intermediate files from the backup version.