Veritas NetBackup™ for DB2 Administrator's Guide

Last Published:
Product(s): NetBackup (8.1)
  1. Introduction to NetBackup for DB2
    1.  
      Features of NetBackup for DB2
    2. NetBackup for DB2 overview
      1.  
        About the NetBackup for DB2 components
      2.  
        About NetBackup for DB2 terminology
  2. Installing NetBackup for DB2
    1.  
      Planning the installation of NetBackup for DB2
    2. Verifying the operating system and platform compatibility
      1.  
        NetBackup server and client requirements
      2.  
        DB2 server software requirements
      3.  
        Requirements for using NetBackup for DB2 in a NetBackup cluster
    3.  
      About the license for NetBackup for DB2
    4. About log archiving
      1.  
        Using the VENDOR archive method
      2.  
        Using the user exit archive method
    5.  
      Specifying the DB2 home path (UNIX)
    6.  
      About adding new DB2 instances
  3. Configuring NetBackup for DB2
    1.  
      Overview of NetBackup for DB2 configuration
    2.  
      About permissions for NetBackup for DB2 log files (UNIX)
    3. About configuring a backup policy for a DB2 database
      1.  
        Adding a new NetBackup for DB2 policy
      2.  
        About policy attributes
      3.  
        Adding clients to a policy
      4.  
        Specifying the master server for a NetBackup for DB2 client
      5.  
        Configuring a policy to back up the configuration files
      6.  
        Configuring the Maximum jobs per client
    4. About adding backup selections to a DB2 policy
      1.  
        About backup schedules, templates, and scripts
      2.  
        Adding a template to the backup selections list in the NetBackup Administration Console
      3.  
        Adding a script to the backup selections list in the NetBackup Administration Console
    5. About adding schedules to a NetBackup for DB2 policy
      1.  
        Configuring an application backup schedule
      2.  
        Example application backup schedule
      3.  
        Configuring automatic backup schedules
      4.  
        Example automatic backup schedule
      5.  
        About schedule properties
      6.  
        NetBackup for DB2 backup types
    6.  
      Performing a manual backup
    7.  
      Reviewing the auto-discovered mappings in Host Management
    8. About backing up archive log files with the user exit program
      1.  
        DB2 objects in the backup window
      2.  
        Configuring a policy to back up the archive logs
      3.  
        Configuring a policy to archive the archive logs
    9. Configuring the run-time environment
      1. Creating a db2.conf file for use with the user exit program
        1.  
          Example db2.conf file using ARCFUNC SAVE
        2.  
          Example db2.conf file using ARCFUNC COPY
      2. Creating a db2.conf file (vendor method)
        1.  
          Example db2.conf file (vendor method)
      3. Configuring bp.conf files in a cluster environment
        1.  
          Configuring a master bp.conf file
        2.  
          Configuring a user bp.conf file
      4.  
        db2.conf keywords
      5.  
        NetBackup for DB2 environment variables
      6.  
        Configuring the logon account for the NetBackup Client Service for NetBackup for DB2
    10. About NetBackup for DB2 templates and shell scripts
      1.  
        Specifying the NetBackup master server from the client
      2.  
        Creating a backup template using the NetBackup for DB2 backup wizard
      3.  
        Creating shell scripts using bpdbsbdb2
      4. Creating DB2 scripts manually
        1.  
          Modifying DB2 backup and install scripts
        2.  
          Script parameters
      5.  
        About NetBackup template and shell script storage
  4. Performing backups and restores of DB2
    1.  
      NetBackup for DB2 backup overview
    2.  
      About backups from the NetBackup master server
    3. About user-directed backups
      1.  
        Using the DB2 template administration interface to run a user-directed backup
      2.  
        Using bpdbsbdb2 to run a user-directed backup
      3.  
        Using DB2 to run a user-directed backup
      4.  
        BACKUP DATABASE command options
    4.  
      Using the Backup, Archive, and Restore interface to browse DB2 resources
    5.  
      About browsing DB2 backup images with bplist
    6. Performing a database restore
      1. Using the NetBackup for DB2 recovery wizard
        1.  
          Selecting files for restore
        2.  
          Using the recovery wizard
        3.  
          Using bpdbsbdb2 for a database restore
      2. Using DB2 to perform a restore
        1.  
          Recovering a DB2 database - Simplest case
        2.  
          Recovering a DB2 database - Restoring archive logs
        3.  
          RESTORE DATABASE command options
    7. About an alternate restore
      1.  
        Preparing the master server for an alternate restore
      2.  
        Performing the alternate restore on the clients
      3.  
        Restoring the transaction logs
  5. Using Snapshot Client with NetBackup for DB2
    1.  
      NetBackup for DB2 with Snapshot Client features
    2. About NetBackup for DB2 with Snapshot Client operations
      1.  
        About the sequence of a NetBackup for DB2 backup operation with Snapshot Client methods
      2.  
        About the sequence of a NetBackup for DB2 restore operation with Snapshot Client methods
      3.  
        About database objects supported by advanced backup methods
      4.  
        About multistreaming and DB2 snapshot backups
      5.  
        About symbolic links and DB2 backups and restores (UNIX)
      6.  
        NetBackup for DB2 stream-based operations
      7.  
        NetBackup for DB2 file-based operations
      8.  
        Example: multiple sessions for a DB2 snapshot backup
    3.  
      About configuring Snapshot Client with NetBackup for DB2
    4.  
      Configuration requirements for snapshot backups with NetBackup for DB2
    5.  
      Configuring a snapshot policy for NetBackup for DB2
    6.  
      About configuring the db2.conf for a snapshot policy
    7. Restoring NetBackup for DB2 from a snapshot backup
      1.  
        About restoring individual files from a NetBackup for DB2 snapshot backup
      2.  
        About NetBackup for DB2 restores of volumes and file systems using snapshot rollback
      3.  
        Performing a NetBackup for DB2 point-in-time rollback restore from a SnapVault backup (UNIX)
      4.  
        Performing a snapshot rollback restore from the Java or Windows interface
      5.  
        Performing a snapshot rollback restore from the command line
      6.  
        Troubleshooting NetBackup for DB2 rollback restores
    8. About configuring NetBackup for DB2 block-level incremental backups on UNIX
      1.  
        How BLI works with NetBackup for DB2 (UNIX)
      2.  
        About the Storage Checkpoint facility and NetBackup for DB2
      3.  
        Configuration requirements for BLI backups with NetBackup for DB2
      4.  
        Storage Checkpoint configuration on the NetBackup for DB2 client
      5. Configuring policies for BLI backups with NetBackup for DB2
        1.  
          About the types of NetBackup for DB2 BLI backups
      6.  
        BLI incremental backup options using NetBackup for DB2
    9. About Snapshot Client effects
      1.  
        How Snapshot Client software affects backup types
      2.  
        How Snapshot Client software affects schedule properties
      3.  
        How Snapshot Client software affects templates and scripts
    10.  
      Performing NetBackup for DB2 backups with Snapshot Client methods
    11.  
      Performing NetBackup for DB2 restores with Snapshot Client methods
  6. Troubleshooting NetBackup for DB2
    1.  
      NetBackup debug logs and reports
    2.  
      Enabling the debug logs for a NetBackup for DB2 client automatically (Windows)
    3.  
      Enabling the debug logs manually (Windows)
    4.  
      Enabling the debug logs manually (UNIX)
    5.  
      Enabling the debug logs manually (UNIX)
    6. About the NetBackup for DB2 log files
      1.  
        About the bphdb directory on the Windows database client
      2.  
        About the bphdb directory on the UNIX database client
      3.  
        About the bpdb2 directory on the UNIX database client
      4.  
        About the bpdbsbdb2 directory on the client
    7.  
      Setting the debug level on a Windows client
    8.  
      Setting the debug level on a UNIX client
    9.  
      About NetBackup server reports
    10.  
      Minimizing timeout failures on large database restores
    11.  
      Minimizing the loading and unloading of tapes for database backups
    12.  
      Use the NET_BUFFER_SZ file to speed up a slow restore
    13.  
      About false restore failures reported in the activity monitor
    14.  
      About the error message codes
    15.  
      Delays in completion of backup jobs
  7. Appendix A. Configuration for a DB2 EEE (DPF) environment
    1.  
      Overview of installation and configuration for a DB2 EEE (DPF) environment
    2.  
      Configuring NetBackup for DB2 in an EEE environment
    3.  
      Adding NetBackup policies for DB2 EEE environment
    4.  
      Backing up archive logs in a DB2 EEE environment
    5.  
      Creating DB2 templates or scripts for a DB2 EEE environment
  8. Appendix B. Using NetBackup for DB2 with SAP®
    1.  
      About NetBackup for DB2 with SAP
    2.  
      Installation of the DB2 user exit program
    3.  
      Backup and restore of DB2 databases used by SAP
    4.  
      Archive and restore of DB2 log files used by SAP
    5.  
      Backup of SAP files
  9. Appendix C. Register authorized locations
    1.  
      Registering authorized locations used by a NetBackup database script-based policy

BLI incremental backup options using NetBackup for DB2

DB2 BLI incremental backups can be initiated several ways. Initiating them from the master server is the recommended method because it requires no special configuration. Operational constraints may necessitate initiating the backups from the client host, two options are available.

Note:

BLI is not currently supported for DB2 Snapshot backups on Microsoft Windows clients, the examples in this section use UNIX Bourne shell syntax. Modify as appropriate if using a different shell.

The following three options describe how to initiate DB2 BLI incremental backups. Some of these options also contain examples of a policy setup that you use and how to modify the backup script

Server-initiated DB2 BLI incremental backups (recommended)

We recommend that you initiate BLI backups from the master server. Initiate the BLI backups using automatic schedules and a Backup Selection that is a script or template. When NetBackup controls the initiation, no special configuration is needed. The policy and the schedule information are provided to the client from the master server. The agent queries the policy and the schedule information and perform the appropriate type of checkpoint; full, cumulative incremental, or differential incremental.

Client-initiated DB2 BLI incremental backups using environment variables

If the backup is initiated from the client, then the schedule from the db2.conf file is used by default. To perform both the full and the incremental backups, the backup script must be enhanced. The enhancement is to ensure the correct type of schedule and associated checkpoint is used. This enhancement can be accomplished by setting the same environment variables that the master server sets before the backup is initiated.

  • Create appropriate automatic full, automatic cumulative incremental, and automatic differential incremental schedules in the DB2 backup policy.

  • Set environment variables to specify the automatic schedule to use before the agent program is executed.

  • Create one db2.conf file in the $DB2_Instance_Home directory. Update the schedule keyword in the database stanza with the name of the application backup schedule to use for any stream-based backups that might occur. The value is overridden with automatic schedule names in the following example.

The following is an example of a policy that has automatic schedules for the snapshot backups and an application schedule for the stream-based backups.

master$ bpplsched DB2_Policy -L | egrep '^Schedule:|^  Type:'
Schedule:              Full
  Type:                FULL SDB2 (0)
Schedule:              Cum
  Type:                CINC (4)
Schedule:              Diff
  Type:                INCR (1)
Schedule:              Default-Application-Backup
  Type:                UBAK DB2 (2)

The policy only has one db2.conf file, and it is set for stream-based backups.

client$ head -4 $DB2_Instance_Home/db2.conf
DATABASE SAMPLE
OBJECTTYPE DATABASE
POLICY DB2_Policy
SCHEDULE Default-Application-Backup

The backup script sets and exports the appropriate environment variables before the backup is initiated.

DB2_INCR=0
DB2_CINC=0
DB2_FULL=0
if [ <some_condition> ]; then
  DB2_INCR=1
  DB2_SCHED="Diff"
elif [ <some_other_condition> ]; then
  DB2_CINC=1
  DB2_SCHED="Cum"
else
  DB2_FULL=1
  DB2_SCHED="Full"
fi

DB2_POLICY=DB2_Policy
DB2_SCHEDULED=1

export DB2_INCR DB2_CINC DB2_FULL DB2_SCHED DB2_POLICY DB2_SCHEDULED

/usr/openv/netbackup/bin/bpdb2proxy <options>
# or 
/usr/openv/netbackup/bin/bpdbsbdb2 <options>
Client-initiated DB2 BLI incremental backups using multiple db2.conf files

If the backup is initiated from the client, then the schedule from the db2.conf file is used by default. The db2.conf file can specify only one policy and schedule for a specific database. To perform both the full and the incremental backups, the backup script must be enhanced. The enhancement is to ensure the correct type of schedule and associated checkpoint is used. This enhancement can be accomplished by updating the db2.conf file before the backup is initiated.

  • Create appropriate automatic full, automatic cumulative incremental, and automatic differential incremental schedules in the DB2 backup policy.

  • Create a db2.conf file to be used with each schedule. In each file, update the schedule keyword in the database stanza with the associated schedule name.

  • Copy the appropriate db2.conf file into place before executing the agent program.

The following is an example of a policy that has automatic schedules for the snapshot backups and an application schedule for the stream-based backups.

master$ bpplsched DB2_DB_Policy -L | egrep '^Schedule:|^  Type:'
Schedule:              Full
  Type:                FULL SDB2 (0)
Schedule:              Cum
  Type:                CINC (4)
Schedule:              Diff
  Type:                INCR (1)
Schedule:              Default-Application-Backup
  Type:                UBAK DB2 (2)

The policy has three db2.conf files, one for each type of automatic backup schedule.

client$ head -4 db2.conf.with_full_schedule
DATABASE SAMPLE
OBJECTTYPE DATABASE
POLICY DB2_DB_Policy
SCHEDULE Full 

client$ head -4 db2.conf.with_cum_schedule
DATABASE SAMPLE
OBJECTTYPE DATABASE
POLICY DB2_DB_Policy
SCHEDULE Cum 

client$ head -4 db2.conf.with_diff_schedule
DATABASE SAMPLE
OBJECTTYPE DATABASE
POLICY DB2_DB_Policy
SCHEDULE Diff

The backup script copies the correct db2.conf file into place before the backup is initiated.

... <setup the rest of the DB2 backup environment> ...

if [ <some_condition> ]; then
  cp db2.conf.with_diff_sched $DB2_Instance_Home/db2.conf
elif [ <some_other_condition> ]; then
  cp db2.conf.with_cum_sched $DB2_Instance_Home /db2.conf
else
  cp db2.conf.with_full_sched $DB2_Instance_Home /db2.conf
fi

/usr/openv/netbackup/bin/bpdb2proxy <options>
# or 
/usr/openv/netbackup/bin/bpdbsbdb2 <options>