NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
cat_export — export catalog image metadata from the NetBackup database (NBDB) to one or more flat ASCII image header files.
SYNOPSIS
-all | -client name | -backupid backupid | -mediahost hostname [-delete_source] [-replace_destination] [-export_dependents] [-export_no_dependents] [-base directory_name]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/
On Windows systems, the directory path to this command is install_path\NetBackup\bin\
DESCRIPTION
The cat_export utility is used in specific scenarios to export image metadata from NBDB to flat ASCII image header files in a target directory. It organizes the data into a directory hierarchy based on the hierarchy that is used in the NetBackup database.
cat_export is normally used in conjunction with the cat_import command as part of a disaster recovery scenario or to relocate image metadata information from one repository to another. More information is available on NetBackup disaster recovery.
For more about Disaster Recovery, see the NetBackup Troubleshooting Guide.
By default, cat_export exports the image metadata that is specified with the -backupid option as well as the image metadata that is dependent on the specified backup images.
You must have administrator privileges to run this command.
OPTIONS
- -all
Exports the catalog image data of all the clients of the master server.
- -base directory_name
Changes the target directory of the catalog metadata from the default directory
netbackup/db.export
to the specified directory name.- -backupid backupid
Exports the catalog image data of the specified backup ID.
- -client name
Exports the catalog image data of the specified client.
- -delete_source
Deletes the original image metadata in NBDB.
- -export_dependents
Used with the -backupid and -client options to export VMware image metadata that is dependent on the specified backup image.
- -export_no_dependents
Used with the -backupid, -client and -mediahost options to export the specified image header but not any of the dependent image metadata.
- -mediahost hostname
Exports the catalog image data that has at least one fragment on the specified media host. The hostname value can be a media server or a snapshot client.
- -replace_destination
Forces the new flat files to overwrite any existing flat files in the target directory.
EXAMPLES
Example 1 - Export all image metadata for alfred
into the /catExport/images/alfred
directory:
# cat_export -base /catExport -client alfred
Example 2 - Export all NBDB image metadata to the netbackup/db.export
directory:
# cat_export -all