Document Outline

• Application Agent CLI User Guide
• Table of Contents
• Preface
• 1 Overview of Application Agent
  • Application Agent features
  • Application Agent functions
    • Backing up data
    • Restoring data
    • Managing data by using dictionary map files
    • Pair management using copy groups
    • Cluster support
    • Reducing workload by using commands
    • Data management on another storage systems
    • Managing generations
• 2 Application Agent system configurations
  • Basic configurations for backing up and restoring data
    • Configurations in which data is backed up and restored within a storage system
    • Configurations in which data can be backed up and restored between two storage systems
      • Continuous Access Software or Continuous Access Journal configuration
      • Business Copy and Continuous Access Software multi-target configuration
      • Business Copy and Continuous Access Journal multi-target configuration
      • Continuous Access Software and Continuous Access Journal multi-target configuration
      • Business Copy (multi-generation), Continuous Access Software, or Continuous Access Journal configuration
    • Precautions on backing up and restoring data between storage systems
    • Configurations using tape devices
  • Configurations for operation in cluster environments
    • Operation-standby cluster configuration
    • Mutual-standby cluster configuration
  • Configurations when VSS is used
  • Requirements and precautions for backing up file systems
  • System configurations for backing up SQL Server databases
    • Configurations for restoring an SQL Server database to a host that is not the original host
    • Configurations for using the log-shipping functionality
    • Cascade configurations
    • Multi-target configurations
  • Requirements and precautions for backing up SQL Server databases
    • Allocating files that comprise a database
    • Allocating multiple database configuration files to one volume
    • Allocating metafiles
    • Using a dynamic disk configuration
    • Using a cluster configuration
  • System configurations for backing up Exchange databases
    • Cascade configurations
    • CCR configurations
      • Configuration in which only the active server is used
      • Configuration in which only the standby server is used
      • Configuration in which different backup servers are used for the active and standby servers
      • Configuration in which the same backup server is used for the active and standby servers
    • SCR configurations
    • DAG configurations
      • Backing up and restoring active mailbox database copies
      • Backing up and restoring passive mailbox database copies
      • Backing up and restoring the active mailbox database copy and the passive mailbox database copy by using different backup servers
      • Backing up and restoring the active mailbox database copy and the passive mailbox database copy by using the same backup server
      • Comparison of DAG configurations
  • Requirements and precautions for backing up Exchange databases
    • Using VSS
    • Restoring backup data obtained using VSS in units of Information Stores
    • Using a cluster configuration
    • Cascade configuration
    • CCR configuration
    • SCR configuration
    • DAG configuration
  • Requirements when using RAID Manager to configure a pair volume
  • Volume configurations usable by Application Agent
    • Examples of disk group configurations usable by Application Agent
  • Requirements and precautions for volume configurations
    • Volume configuration requirements
    • Precautions when changing a volume configuration
    • Requirements and precautions when a disk group Is configured
      • Using dynamic disks in Veritas Storage Foundation
      • Backing up and restoring dynamic disks by dynamically or statically recognizing secondary volumes
      • Expanding dynamic volumes
    • Precautions for partition styles for disks
• 3 Preparation for using Application Agent
  • Setting up an environment for Application Agent
  • Setting up RAID Manager
    • Backing up one primary volume to multiple generations
    • Backing up multiple primary volumes to a single generation
    • Backing up multiple primary volumes to multiple generations
    • Backup or restore between storage systems
    • Setting up a multi-target or cascade configuration
  • Setting up operation of Application Agent
    • Specifying the retry count and interval for cluster resource status retry check
    • Specifying the retry count and interval for process status retry check
    • Specifying the retry count and interval for command execution status retry check
    • Setting up the backup option for SQL Server database backup
    • Setting up the dictionary map synchronization option for SQL Server database backup
    • Setting up the recovery option for SQL Server database backup
    • Setting up restoration while cluster resources are online
    • Setting up parallel execution of verification processes for Exchange database backup
    • Setting communication timeout periods for the Protection Manager service
  • Setting up Application Agent for linkage with RAID Manager
    • Specifying instance numbers
    • Specifying a retry count and interval for pair status retry checking
    • Specifying a retry count and interval for RAID Manager command busy retry checking
    • Specifying a retry count and interval appropriate to operation style
    • Specifying track sizes used when copying data
    • Specifying volume pair creation
    • Settings for using secondary volume dynamic recognition
    • Setting up operation mode when automatically selecting copy groups
    • Notes on starting and stopping RAID Manager
    • Specifying the installation path for RAID Manager
    • Specifying modification of pair status if a backup error occurs
  • Creating dictionary map files
    • Creation in a non-cluster configuration or on a backup server
    • Creation in an Active-Passive cluster configuration
    • Creation in an Active-Active cluster configuration
    • Creation in a cascade configuration for Exchange database backup
  • Specifying cluster configuration settings and creating a definition file
    • Settings related to shared disks and cluster groups
      • How to define a cluster group (when a backup target and shared disks are to be in the same cluster group)
      • How to Define Cluster Groups (When a Backup Target and Shared Disks Are to Be in Separate Cluster Groups)
    • Creating a cluster information configuration definition file when using Veritas cluster server
  • Creating a database configuration definition file
    • Creating a configuration definition file for SQL Server database backup
  • Specifying settings related to linkage with an SQL Server
  • Specifying settings for using VSS
    • Using VSS with RMXP Shadow Copy Provider version 01-02-03/03 or later
    • Using VSS with RMXP Shadow Copy Provider version 01-02-03/02 or earlier
  • Creating a cascade configuration definition file for Exchange database backup
  • Setting up linkage with a tape backup management software
    • Registering information for linkage with a tape backup management software
    • Creating a configuration definition file for tape backup
      • Configuration parameters
      • Configuration file examples
      • User-defined configuration definition file
  • Creating a list file
    • Creating a copy-group list file
    • Creating a database list file or mount point directory list file
      • Commands that support a target definition file
      • File name of the list file
      • List file storage location
      • Contents of the list file
    • Creating a transaction log list file
      • File name of the transaction log list file
      • Transaction log list file storage location
      • Contents of the transaction log list file
      • Creation of a transaction log list file
  • Updating a dictionary map file
  • Specifying how to mount a secondary volume
    • Making the OS dynamically recognize the secondary volume
    • Making the OS statically recognize the secondary volume
    • Determining a mount point and mount target when mounting a secondary volume
      • Determination of a mount point
      • Determination of a mount target
  • Preparations required before executing extended commands
    • Checking the prerequisite conditions
      • Execution permissions for extended commands
      • Automatic execution of extended commands
      • Prerequisite VBScript version
      • Deletion of unnecessary files
    • Setting up an FTP service for backing up to tape
    • Specifying how to start the extended commands
    • Creating a host environment settings file
    • Creating operation IDs
    • Creating operation definition files for file system backup
      • Deployment of operation definition files
      • Format of operation definition files
      • Example of creating operation definition files (in a cluster configuration)
    • Creating operation definition files for SQL Server database backup
      • Deployment of operation definition files
      • Format of operation definition files
      • Example of creating operation definition files
    • Creating operation definition files for Exchange database backup
      • Deployment of operation definition files
      • Format of operation definition files
      • Example of creating operation definition files
    • Checking the temporary directory for extended commands
    • Checking the copy-group list file
    • Checking the FTP service (if you are going to back up to tape)
  • Creating a user script
    • Overview of user scripts
    • Coding rules for user scripts
      • Coding rules for user scripts
      • Entries in user scripts
      • Script environment variables
      • Command execution permission
      • Commands that can be specified in user pre-processing and user post-processing
    • Examples of user script usage
  • Specifying settings for sending mail
  • Backing up the Application Agent operating environment
    • Files that need to be backed up
      • Application Agent environment setting files and log files
      • Definition files created after the installation of Application Agent
      • Application Agent backup information
    • Recovering the operating environment
      • Recovering operating environment (common among servers)
      • Recovering backup information (file server)
      • Recovering backup information (database server)
      • Restoring backup information (backup server)
  • Creating the Exchange environment configuration file
• 4 Application Agent operations
  • Application Agent commands
    • Extended commands
    • Basic commands
  • Correspondence between extended commands and basic commands
  • Precautions on operations
    • Precautions on operations
    • Precautions on backup and restoration
    • Precautions on backup
    • Precautions on restoration
    • Precautions when executing commands simultaneously
    • Precautions for executing commands in a cluster environment
    • Precautions regarding backup servers
      • Precautions when mounting
      • Precautions regarding the drive when mounting data to a backup server
      • Precautions when importing backup information
      • Command execution conditions
    • Precautions when updating dictionary map files
    • Unavailable tools when executing commands
    • Disk group configuration that does not allow backup (dynamic disk configuration)
    • Notes on pair volume resynchronization in a cascade configuration
  • Precautions when executing commands
    • Permissions required for users executing commands
    • Possibility of concurrent execution with other commands
    • Retry time when an error occurs
    • Stopping retry operations caused by a command that cannot execute concurrently with other commands
    • Executing multiple drmmediabackup or drmmediarestore commands concurrently
    • Configurations that requires RAID Manager user authentication
  • Starting and stopping the Protection Manager service
    • Starting the Protection Manager service
    • Restarting the Protection Manager service
    • Stopping the Protection Manager service
• 5 Operation for file systems
  • Backing up and restoring a file system
    • Precautions when backing up a file system
    • Precautions when restoring a file system
    • Precautions when executing commands in a cluster environment
    • Precautions on forced termination of commands
  • Backing up and restoring data between volumes
    • System configuration
    • Processing flow
    • Backing up a file system to a secondary volume
    • Restoring a file system to a primary volume
  • Backing up and restoring by using a tape device
    • System configuration
    • Flow of processing
    • Backing up a file system to tape
      • Resynchronizing copy groups
      • Backing up a file system
      • Backup using VSS
    • Restoring a file system from tape
  • Backing up a file system by using a user script
    • System configuration
    • Processing flow
    • User script example
    • Backup execution example
  • Backing up and restoring between local sites and remote sites
    • Backing up a file system to a remote site
      • Operations at the local site
      • Operations at the remote site
      • Operations at the local site
    • Restoring a file system to the local site
      • Operations at the remote site
      • Operations at the local site
    • Restoring a file system to a remote site
      • Operations at the remote site
    • Recovering a file system from a remote site to the local site
      • Operations at the local site
      • Operations at the remote site
      • Operations at the local site
  • Backing up and restoring a file system by using a tape backup management software that cannot link with Application Agent
  • Backing up and restoring a file system by using a file share
    • Preparing to back up or restore a file system by using a file share
    • Example of backing up a file system by using a file share
    • Example of restoring a file system by using a file share
  • Deleting backup data
• 6 Operation for SQL Server databases
  • Backing up and restoring an SQL Server database
    • Precautions when backing up and restoring a database
    • Precautions when restoring a database
    • Precautions when recovering a database
    • Precautions when backing up and restoring multiple databases
      • When multiple databases are stored in the same volume
      • When multiple databases are stored in multiple volumes
    • Database status when restoring and recovering
    • Requirements for transaction log backup
    • Precautions regarding backup of transaction logs
    • Precautions regarding sequences of transaction logs
      • Transaction log backups after roll-forward
    • Precautions regarding application of transaction logs
      • Recovering the SQL Server database from the last backup data
      • Recovering the SQL Server database from backup data existing prior to the last backup data
    • SQL Server database requirements for executing commands
      • Service status
      • Database status
      • Database type
  • Backing up and restoring data between volumes
    • System configuration
    • Processing flow
    • Backing up an SQL Server database to a secondary volume
    • Restoring an SQL Server database to a primary volume
      • Restoring an SQL Server database
      • Using the drmsqlrecover command to recover an SQL Server database
      • Using the drmsqlrecovertool dialog box to recover an SQL Server database
  • Backing up and restoring by using a tape device
    • System configuration
    • Processing flow
    • Backing up an SQL Server database to tape
      • Resynchronizing copy groups
      • Backing up an SQL Server database
    • Restoring an SQL Server database from tape
      • Restoring an SQL Server database
      • Recovering an SQL Server database with the drmsqlrecover command
      • Recovering an SQL Server database using the drmsqlrecovertool dialog box
  • Backing up an SQL Server database by using a user script
    • System configuration
    • Processing flow
    • User script example
    • Backup execution example
  • Operation using SQL Server transaction logs
    • System configuration
    • Example of operation using a transaction log backup
    • Backing up an SQL Server database
      • Resynchronizing copy groups
      • Backing up an SQL Server database
    • Backing up transaction logs
    • Restoring SQL Server databases
    • Applying the drmsqlrecovertool dialog box to restore an SQL Server database
      • Using the drmsqlrecovertool dialog box to recover an SQL Server database
      • Using the drmsqlrecover command to recover an SQL Server database (using a transaction log list file)
    • Example of operation using transaction log backup
  • Backing up and restoring transaction log backup files
    • System configuration
    • Backing up the transaction log backup file
    • Restoring the transaction log backup file
  • Backing up and restoring multiple generations by locking a copy group
    • Example of operation using lock functionality and generation management
    • Locking a copy group
    • Unlocking a copy group
  • Backing up and restoring between local sites and remote sites
    • Backing up an SQL Server database to a remote site
      • Operation at the local site
      • Operation at the remote site
      • Operation at the local site
    • Restoring an SQL Server database to the local site
      • Operation at the remote site
      • Operation at the local site
    • Restoring an SQL Server database to a remote site
      • Operation at the remote site
    • Recovering data from the remote site to the local site
      • Operation at the local site
      • Operation at the remote site
      • Operation at the local site
  • Backing up and restoring in a multi-target configuration
    • Example of backing up an SQL Server database
    • Example of restoring an SQL Server database
  • Performing restoration and recovery on a host other than the backup host
  • Using the SQL Server log-shipping function
    • Before using the log-shipping function
    • Setting a distribution target server as an operating server
  • Backing up and restoring in a cascade configuration or multi-target configuration
    • Preparations for performing backup or restoration in a cascade configuration or multi-target configuration
    • Creating a user script to perform a backup in a cascade configuration
      • Outline of user script files
      • Coding rules for user script files
      • Sample user script files
    • Backing up an SQL Server database in a cascade configuration
    • Backing up transaction logs in a cascade configuration without a backup catalog
    • Restoring an SQL Server database in a cascade configuration
  • Backing up and restoring using a tape backup management software that cannot link with Application Agent
  • Backing up and restoring an SQL Server database by using a file share
    • Preparing to back up or restore by using a file share
    • Backing up an SQL Server database by using a file share
    • Example of restoring a database by using a file share
  • Restoring data to an SQL Server instance that is different from the backup source
    • System configuration
    • Operation flow
      • Preparations for restoration (recovery)
      • Operations for restoration (recovery)
    • Operation example
      • Example of restoring an SQL Server database from tape and recovering on the secondary volume
      • Example of restoring (recovering) an SQL Server database on the log distribution destination
      • Example of restoring (recovering) an SQL Server database on the primary volume
  • Deleting backup data
  • Making an SQL Server database backed up to a secondary volume available for use
    • System configuration
    • User script example
      • script1.txt (used for data mining)
      • script2.txt (used for backup)
    • Example
  • Backing up and restoring when using an SQL Server replication configuration
    • System configuration
      • Requirements for the publication database and the distribution database
      • Requirements for the subscription database
    • Example
      • Back up the databases
      • Back up the transaction logs of the publication database
      • Prepare for database restoration
      • Restore the databases
      • Perform database recovery
      • Prepare to restart operations
    • Setting and checking the 'sync with backup' option
      • How to set the 'sync with backup' option
      • How to check the 'sync with backup' option
  • Backing up and restoring in an SQL Server AlwaysOn availability group configuration
    • System configuration
    • Backing up and restoring a user database to the active server
    • Restoring a user database to the standby server from the active server
    • Restoring a user database to the secondary-use server from the active server
• 7 Operation for Exchange databases
  • Backing up and restoring a storage group
    • Precautions when backing up an Exchange database
    • Precautions when restoring an Exchange database
      • Precautions when restoring from a tape
      • Note on performing a recovery using roll forward
      • Procedure for handing the message (KAVX1510-E)
      • Notes on restoring data obtained with a VSS backup
      • Procedure for when the Information Store cannot be mounted
    • Precautions on recovery storage groups and recovery databases
    • Precautions when configuring volumes
  • Backing up and restoring data between volumes by using VSS
    • System configuration
    • Processing flow
    • Backing up storage groups to a secondary volume
    • Restoring storage groups to a primary volume
  • Backing up and restoring by using a tape device
    • System configuration
    • Processing flow
    • Backing up storage groups to tape
      • Resynchronizing copy groups
      • Backup using VSS
    • Restoring storage groups from tape
  • Backing up a storage group by using a user script
    • System configuration
    • Processing flow
    • User script example
    • Backup execution example
  • Restoring by using transaction logs (Roll-forward)
    • System configuration
    • Rolling forward the transaction logs at the time of restoration
  • Backing up and restoring between local sites and remote sites
    • Backing up storage groups to a remote site
      • Operations at the local site
      • Operations at the remote site
      • Operations at the local site
    • Restoring a storage group to a local site
      • Operations at the remote site
      • Operations at the local site
  • Backing up and restoring in a cascade configuration
    • Backing up concurrently at both local and remote sites
      • Operation at the local site
      • Operation at both the local and remote sites
    • Restoring data using the backup data at the local site
    • Restoring data using the backup data at the remote site
  • Backing up and restoring in a CCR configuration
    • Using different backup servers for the active and standby servers
      • Performing a backup on the active server
      • Performing a backup on the standby server
    • Restoring data when using the automatic seed function
      • Restoring backup data acquired on the active server (when the automatic seed function is used)
      • Restoring backup data acquired on the standby server (when the automatic seed function is used)
    • Restoring data when not using the automatic seed function
      • Restoring backup data acquired on the active server (when the automatic seed function is not used)
      • Restoring backup data acquired on the standby server (when the automatic seed function is not used)
  • Backing up and restoring in SCR configurations
    • System configuration
    • Backing up in an SCR configuration
    • Roll-forward recovery on backed up data acquired in an SCR configuration
    • Point-in-time restoration when not using the SCR seed function
    • Point-in-time restoration when using the SCR seed function
  • Backing up and restoring in DAG configurations
    • System Configuration
    • Backing up active mailbox database copies
    • Backing up passive mailbox database copies
    • Restoring backup data of an active mailbox database copy
    • Restoring backup data of a passive mailbox database copy
  • Backing up and restoring storage groups using a tape backup management software that is unable to link with Application Agent
  • Backing up and restoring storage groups by using a file share
    • Preparing to use a file share for storage group backup and restore
    • Example of using a file share for storage group backup
    • Example of using a file share for storage group restoration
  • Deleting backup data
• 8 Troubleshooting
  • Troubleshooting procedure
  • Troubleshooting extended commands
  • Data required for troubleshooting
    • Data required for troubleshooting
      • OS log information
      • Application Agent information
      • RAID Manager information
      • Database information (when the backup is of an SQL Server database or Exchange database)
      • Other information
      • Operation details
    • Log files output by extended commands
  • Adjusting trace log settings
    • Adjusting the output level for detailed trace log information
    • Adjusting the number of log files for detailed trace log information
  • Investigating collected data
    • Investigating standard output logs
    • Investigating the trace logs for Application Agent-cooperative software
    • Investigating the detailed trace log
  • Troubleshooting dictionary map file errors
    • Displaying dictionary map file information or backup information
    • Recreating dictionary map files
• 9 Support and other resources
  • Contacting HP
    • HP technical support
    • Subscription service
    • Documentation feedback
  • Related information
  • Conventions
• A Example of an Application Agent environment configuration
  • System configuration
    • Server configuration
    • Storage system configuration
  • Example settings for the RAID Manager configuration definition file
  • Example settings for the Application Agent configuration definition file (init.conf)
  • Example settings for the RAID Manager-linkage definition file (DEFAULT.dat)
  • Example of creating dictionary map files
  • Example of registering SQL Server information
  • Example settings for linkage to tape backup management software
    • Example registering information for linkage to the tape backup management software
    • Example of the configuration definition file for tape backup
  • Example settings for the host environment settings file
  • Example settings for an operation definition file
  • Example settings for a copy-group list file
• B List of files used in Application Agent
  • List of files used in Application Agent
• C Replacing primary and secondary volume disks while Application Agent is running
  • Replacing primary and secondary volume disks while Application Agent is running
  • Procedure for replacing a primary volume disk
  • Procedure for replacing a secondary volume disk
• D Restoring from a tape directly to a primary volume in a Fast Snap or Snapshot configuration
  • Example of Fast Snap or Snapshot configuration
  • Procedure for backing up to tape on the backup server
  • Procedure for restoring from tape directly to the primary volume
• E Correspondence to Replication Manager GUI terms
  • Correspondence to Replication Manager GUI terms
• Glossary
• Index