EMC AVAMAR 6.0 GUIDE FOR IBM DB2 P/N REV A01 EMC CORPORATION CORPORATE HEADQUARTERS: HOPKINTON, MA

Transcription

1 EMC AVAMAR 6.0 FOR IBM DB2 GUIDE P/N REV A01 EMC CORPORATION CORPORATE HEADQUARTERS: HOPKINTON, MA

2 Copyright and Trademark Notices Copyright EMC Corporation. All rights reserved. Published April, 2011 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories section on EMC Powerlink. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 2

3 TABLE OF CONTENTS Preface Scope and intended audience Product information Avamar Support Your comments Typographic conventions Safety admonitions and notices Introduction System requirements Software Hardware Capabilities and limitations Installation and Configuration Preinstallation checks Client registration Installing the Avamar for DB2 Client on IBM AIX Download Avamar AIX DB2 install packages Install and register the Avamar for AIX Client Install and configure the Avamar DB2 plug-in Uninstalling the Avamar for DB2 Client on IBM AIX Upgrading the Avamar for DB2 Client on IBM AIX Installing the Avamar for DB2 Client on Microsoft Windows Install the Avamar for Windows Client Register the Avamar for Windows Client Install the Avamar Windows DB2 plug-in Uninstalling and upgrading the Avamar for DB2 Client on Microsoft Windows Installing the Avamar for DB2 Client on Red Hat Enterprise Linux Download Avamar Linux DB2 install packages Install and register the Avamar for Linux Client Install and Configure the Avamar DB2 Plug-In Uninstalling and upgrading the Avamar for DB2 Client on Red Hat Enterprise Linux Upgrading the Avamar for DB2 Client on Red Hat Enterprise Linux EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 3

4 TABLE OF CONTENTS Backup Database preparation On-demand backup Scheduling DB2 server backups Creating a dataset for DB2 server backups Setting up scheduled DB2 server backups Enabling scheduled DB2 server backups Restore and Recovery Database preparation Restore overview Locating and selecting a backup Restoring from an offline backup Restoring from an online backup with archive logs Restoring and recovering the database Restoring only the database Restoring only the archive logs Restoring from an online backup without archive logs Appendix A Plug-in Options Important terms and concepts DB2 plug-in options EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 4

5 PREFACE Scope and intended audience Scope. This guide describes how to install, configure, administer, and use the Avamar for DB2 Client. Intended audience. The information in this guide is primarily intended for: System administrators who are responsible for installing software and maintaining servers and clients on a network Database administrators (DBAs) who are responsible for backing up and maintaining DB2 databases Prerequisites. Persons using this guide should have current practical experience with the following: Operating system shell commands (root permission required) The specific version of DB2 software currently deployed at the site Product information For current documentation, release notes, software updates, information about EMC products, licensing, and service, go to the EMC Powerlink website at EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 5

6 Your comments PREFACE Avamar Support Before contacting EMC Technical Support, please go to the Avamar Support landing page at and: Refer to the Product Documentation Check the listed Support Topics for: How-to's Troubleshooting Search the Avamar Knowledge Base (KB) for applicable solutions using the convenient search engine: Enter the KB solution number (for example, esgxxxxxx) Enter keywords If none of the previous resources resolve your issue, many issues can be successfully resolved through live interactive chat. You can engage EMC Technical Support using live interactive chat by selecting Additional Resources > Live Chat on the Avamar Support landing page. If more in-depth help is required, or if you have an existing open Service Request (SR), you can submit or review a service request through Powerlink: To review an existing SR, go to and select Support > Request Support > View Service Requests To open a new SR, go to: and select Support > Request Support > Create Service Request EMC recommends that all Avamar systems have ConnectEMC and Home enabled to facilitate the best possible support. Systems with ConnectEMC configured and enabled will be able to automatically generate SRs when appropriate and as noted in this guide. Your comments Your suggestions will help us continue to improve the accuracy, organization, and overall quality of our documentation. You may comments to: BSGDocumentation@EMC.com Please include the following information: Product name and version Document name, part number, and revision (for example, A01) Page numbers Other details that will help us address the documentation issue EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 6

7 Typographic conventions PREFACE Typographic conventions The following table provides examples of standard typographic styles used in this guide to convey various kinds of information. EXAMPLE Click OK. or Select File > Close. Type: cd /tmp --logfile=file Installation Complete. DESCRIPTION Bold text denotes actual buttons, commands, menus, and options that initiate action. Sequential commands are separated by a greaterthan (>) character. For example, the second example instructs you to select the Close command from the File menu. Bold fixed-width text denotes shell commands that must be entered exactly as they appear. All caps text often denotes a placeholder (token) for an actual value that must be supplied by the user. In this example, FILE would be an actual filename. Regular (not bold) fixed-width text denotes command shell messages, code, and file contents. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 7

8 Safety admonitions and notices PREFACE Safety admonitions and notices The following safety admonitions and notices appear in this guide: Danger safety admonitions indicate a hazardous situation which, if not avoided, will result in death or serious injury. Warning safety admonitions indicate a hazardous situation which, if not avoided, could result in death or serious injury. Caution safety admonitions indicate a hazardous situation which, if not avoided, could result in minor or moderate injury. IMPORTANT: Important notices contain information essential to software or hardware operation. NOTE: Notes contain information intended to clarify a topic or procedure. Notes never contain information that will cause a failure if ignored. TIP: Tips present optional information intended to improve your productivity or otherwise enhance your experience with the product. Tips never contain information that will cause a failure if ignored. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 8

9 INTRODUCTION EMC Avamar for DB2 provides a complete backup and restore solution for DB2 databases. Once a database has been backed up to the Avamar system, the entire database can be quickly restored without having to locate and mount tapes or optical media. System requirements This topic lists the supported configurations and hardware requirements that must be satisfied to successfully install and deploy the Avamar for DB2 Client backup and recovery solution. The Supported Configurations table also lists the correct Avamar for DB2 Client software installation package required for each DB2 version, host platform, and operating system. Software Before installation, review the EMC Avamar Compatibility and Interoperability Matrix on Powerlink ( to ensure that Avamar software is compatible with the operating system and DB2 software. Hardware REQUIREMENT MINIMUM RAM Hard Drive Space Network Interface 64 MB. 130 MB permanent hard drive space for software installation. The Avamar client software also requires an additional 12 MB of permanent hard drive space for each 64 MB of physical RAM. This space is used for local cache files. 10BaseT minimum; 100BaseT or higher recommended, configured with latest drivers for the platform. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 9

10 Capabilities and limitations INTRODUCTION Capabilities and limitations This topic discusses current capabilities and limitations of the Avamar for DB2 Client. Avamar for DB2 Client only supports one database instance per server. Avamar only supports backup of a single instance of DB2 on each server. Attempting to back up multiple instances on the same server (regardless of version) fails. Redirected restores must be to the same client. When performing a redirected restore, the restore target directory must be on the same client from which the backup was originally taken. Restores to other clients are not supported. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 10

11 INSTALLATION AND CONFIGURATION This chapter describes how to install and configure Avamar for DB2 Client software on the server that hosts the DB2 database. Five basic server platforms are supported: IBM AIX 5.2, 5.3 and bit Microsoft Windows 2003, 2008 R1, and 2008 R2 x64 Microsoft Windows Server bit Red Hat Enterprise Linux 4 32-bit Red Hat Enterprise Linux 4 and 5 64-bit SuSE Linux 10 and bit SuSE Linux 10 and bit The Preinstallation checks (page 12) and Client registration (page 13) tasks apply to all server platforms. However, there are separate client installation procedures for each platform. Software installation packages. The following table lists the software packages required to install Avamar for DB2 Client software. Each installation requires two software packages: the filesystem client and the DB2 plug-in. OPERATING SYSTEM IBM AIX 5.2 and bit IBM AIX bit Microsoft Windows Server bit Microsoft Windows 2003, 2008 R1 and 2008 R2 x64 Red Hat Enterprise Linux 4 32-bit SOFTWARE INSTALLATION PACKAGES AvamarClient-aix5-ppc-VERSION.bff AvamarDB2-aix5-ppc64-VERSION.bff AvamarClient-aix6-ppc-VERSION.bff AvamarDB2-aix6-ppc64-VERSION.bff AvamarClient-windows-x86-VERSION.msi AvamarDB2-windows-x86-VERSION.msi AvamarClient-windows-x86_64-VERSION.msi AvamarDB2-windows-x86_64-VERSION.msi AvamarClient-linux-rhel4-x86-VERSION.rpm AvamarDB2-linux-rhel4-x86-VERSION.rpm EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 11

12 Preinstallation checks INSTALLATION AND CONFIGURATION OPERATING SYSTEM Red Hat Enterprise Linux 4 and 5 64-bit SUSE Linux Enterprise Server bit SUSE Linux Enterprise Server bit SUSE Linux Enterprise Server 10 and bit SOFTWARE INSTALLATION PACKAGES AvamarClient-linux-rhel4-x86_64-VERSION.rpm AvamarDB2-linux-rhel4-x86_64-VERSION.rpm AvamarClient-linux-rhel4-x86-VERSION.rpm AvamarDB2-linux-rhel4-x86-VERSION.rpm AvamarClient-linux-sles11-x86-VERSION.rpm AvamarDB2-linux-sles11-x86-VERSION.rpm AvamarClient-linux-rhel4-x86_64-VERSION.rpm AvamarDB2-linux-rhel4-x86_64-VERSION.rpm Preinstallation checks Before you install any Avamar software, perform the following checks: 1. Ensure that you have operating system root privileges on the computer that hosts the DB2 server. 2. Ensure that DB2 is installed and functioning properly. 3. Ensure that the Avamar server is operational and present on the same network as the DB2 server. You can verify this by opening a command shell on the DB2 server and typing the following: ping AVAMARSERVER where AVAMARSERVER is the network hostname (as defined in DNS) or IP address of the Avamar server. 4. Note the network hostname for the Avamar server and utility node. These DNS entries should have been added during deployment of the Avamar system. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 12

13 Client registration INSTALLATION AND CONFIGURATION Client registration You must register the client to establish the client with the Avamar server. A complete discussion of registering and activating new Avamar clients, domains, and user accounts is beyond the scope of this guide. The EMC Avamar Administration Guide provides additional information. To register the client: 1. In Avamar Administrator, click the Administration launcher button. The Administration window appears. 2. Click the Account Management tab. 3. Select the domain for the client. TIP: You can add this client to an existing Avamar domain, or you may also want to consider adding a domain to the Avamar system to segregate clients that perform DB2 backups from clients that back up physical filesystems. The EMC Avamar Administration Guide provides additional information. 4. Select Actions > Account Management > New Client. The New Client dialog box appears. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 13

14 Client registration INSTALLATION AND CONFIGURATION 5. Type the information for the client as discussed in the following table. FIELD New client name Contact Phone Location DESCRIPTION Name for the new client. IMPORTANT: To ensure error-free client registration, the Avamar client name must be the actual DB2 server network hostname as defined in DNS. Optional contact name. Optional contact telephone number. Optional contact address. Optional contact location. 6. Click OK. The New Client dialog box closes, and the new client appears in the Account Management tree pane. 7. Switch to the Administration window. 8. Click the Account Management tab. 9. Select the client that you added. 10. Select Actions > Account Management > New User(s) to create a user account for the client. The New User dialog box appears. 11. Type the information for the user as discussed in the following table. FIELD/OPTION Authentication System Everyone DESCRIPTION Select either the default internal Avamar Authentication System, or any external authentication system that you have configured to work with Avamar. Select this option to designate privileges for all users on this client. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 14

15 Client registration INSTALLATION AND CONFIGURATION FIELD/OPTION User Name Role Password Confirm DESCRIPTION Select this option and type the new username. IMPORTANT: If you are using an external authentication system, this must be the username that you use to log in to that system. Select the backup and restore privilege for this user. Type a password for the new user. Avamar passwords must be at least six characters long. If you are using an external authentication system, leave the box blank. Type the password again to confirm that you did not type it incorrectly in the Password box. If you are using an external authentication system, leave the box blank. 12. Click OK. The following status message appears: User added. 13. Click OK. The status message closes and the new user appears in the list of users for the client. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 15

16 Installing the Avamar for DB2 Client on IBM AIX INSTALLATION AND CONFIGURATION Installing the Avamar for DB2 Client on IBM AIX Task list. To install the Avamar for DB2 Client on supported IBM AIX platforms: Download Avamar AIX DB2 install packages (page 16) Install and register the Avamar for AIX Client (page 17) Install and configure the Avamar DB2 plug-in (page 19) Download Avamar AIX DB2 install packages 1. Log in to the computer that hosts the DB2 server. 2. Open a web browser and type the following URL: where AVAMARSERVER is the Avamar system network hostname (as defined in DNS) or IP address. You are automatically redirected to the Avamar secure web server. 3. If a security alert dialog box appears due to browser security settings, click Yes or OK to allow redirection to the Avamar secure web server. The Secure Log On page appears. 4. Scroll down until the Downloads and Documents hyperlink is visible. 5. Click Downloads and Documents. The Downloads and Documentation page appears. 6. Click the correct operating system hyperlink for the computer that hosts the DB2 server. A directory listing appears. 7. Download the Avamar for AIX Client install package to a temporary install directory on the system. 8. Note the Avamar for AIX Client install package filename. 9. Download the Avamar DB2 plug-in install package to the same directory as the Avamar for AIX Client install package. 10. Note the Avamar DB2 plug-in install package filename. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 16

17 Install and register the Avamar for AIX Client Installing the Avamar for DB2 Client on IBM AIX INSTALLATION AND CONFIGURATION User=root 1. Open a command shell and log in to the computer that hosts the DB2 server as root. 2. Start the installation by typing: cd /tmp geninstall -d AvamarClient-aix5-ppc-VERSION.bff all where /tmp is the temporary install directory and AvamarClient-aix5-ppc- VERSION.bff is the Avamar for AIX Client install package that you downloaded. The following appears in the command shell: Pre-installation Verification Verifying selections...done Verifying requisites...done Results... SUCCESSES Filesets listed in this section passed pre-installation verification and will be installed. Selected Filesets AVMRclnt # Avamar for AIX Client << End of Success Section >> FILESET STATISTICS Selected to be installed, of which: 1 Passed pre-installation verification Total to be installed Filesystem size changed to Installing Software installp: APPLYING software for: AVMRclnt << Copyright notice for AVMRclnt >> This software is copyright EMC Please read and agree to the End User License Agreement which will be placed in the base directory of the install as a file named AvamarClient-License.txt << End of copyright notice for AVMRclnt >>.... Installation complete You may run /usr/local/avamar/bin/avregister to register and activate this client with the Administrator server. avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id avagent.d Info: Client Agent started. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 17

18 Installing the Avamar for DB2 Client on IBM AIX INSTALLATION AND CONFIGURATION Finished processing all filesets. (Total time: 9 secs) Summaries: Installation Summary Name Level Part Event Result AVMRclnt USR APPLY SUCCESS 3. Register the client with the Avamar server by typing: /usr/local/avamar/bin/avregister The following appears in the command shell: === Client Registration and Activation This script will register and activate the client with the Administrator server. Enter the base directory of the Avamar Client installation [/usr/local/avamar]: 4. Press Enter to accept the default base installation directory. The following appears in the command shell: Enter the Administrator server address (DNS text name or numeric IP address, DNS name preferred): 5. Type the network hostname (as defined in DNS) of the Avamar Administrator server and press Enter. The following appears in the command shell: Enter the Avamar server domain [clients]:avamar The default domain is clients. However, the Avamar system administrator may have defined other domains and subdomains. Consult the Avamar system administrator for the domain to use when registering this client. IMPORTANT: If you specify a subdomain (for example, clients/myclients), then do not include a slash (/) as the first character. Including a slash as the first character causes an error and prevents you from registering this client. 6. Press Enter to accept the default domain (clients). The following appears in the command shell: avagent.d Info: Server stopped. avagent Info <5241>: Logging to ///usr/local/avamar//var/avagent.log avagent.d Info: Client activated successfully. avagent.d Info: start avagent Info <5241>: Logging to ///usr/local/avamar//var/avagent.log avagent Info <5417>: daemonized as process id avagent.d Info: Server started. Registration Complete. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 18

19 Install and configure the Avamar DB2 plug-in Installing the Avamar for DB2 Client on IBM AIX INSTALLATION AND CONFIGURATION IMPORTANT: You must Install and register the Avamar for AIX Client (page 17) before installing the Avamar DB2 Plug- In. User=root 1. Ensure that you are still logged in to the computer that hosts the DB2 server as root. 2. Install the Avamar DB2 plug-in software by typing: cd /tmp geninstall -d AvamarDB2-aix5-ppc64-VERSION.bff all where /tmp is the temporary install directory and AvamarDB2-aix5-ppc64- VERSION.bff is the Avamar DB2 plug-in install package that you downloaded. The following appears in the command shell: Pre-installation Verification Verifying selections...done Verifying requisites...done Results... SUCCESSES Filesets listed in this section passed pre-installation verification and will be installed. Selected Filesets AvamarDB2-aix5-ppc # EMC Avamar client << End of Success Section >> BUILDDATE Verification Verifying build dates...done FILESET STATISTICS Selected to be installed, of which: 1 Passed pre-installation verification Total to be installed Installing Software installp: APPLYING software for: AvamarDB2-aix5-ppc << Copyright notice for AvamarDB2-aix5-ppc64 >> This software is copyright EMC Corporation, EMC Please read and agree to the End User License Agreement which will be placed in the base directory of the install as a file EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 19

20 Installing the Avamar for DB2 Client on IBM AIX INSTALLATION AND CONFIGURATION named AvamarClient-License.txt << End of copyright notice for AvamarDB2-aix5-ppc64 >>.... installdir is /usr/local/avamar total 40 -rw-r--r-- 1 root system Aug 19 10:51 AvamarClient-License.txt drwxr-xr-x staff 4096 Aug 19 10:55 bin drwxr-xr-x staff 256 Aug 19 10:55 etc drwxr-xr-x staff 256 Aug 19 11:41 lib drwxr-xr-x staff 256 Aug 19 10:55 lib64 lrwxrwxrwx 1 root system 11 Aug 19 11:40 var -> /var/avamar avagent.d Info: Stopping Avamar Client Agent (avagent)... avagent.d Info: Client Agent stopped. avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id avagent.d Info: Client Agent started. Installation complete You may run /usr/local/avamar/bin/avdb2setup to configure this module to backup to the dpn. Finished processing all filesets. (Total time: 5 secs) Summaries: Installation Summary Name Level Part Event Result AvamarDB2-aix5-ppc USR APPLY SUCCESS 3. Configure the DB2 plug-in software by typing: /usr/local/avamar/bin/avdb2setup The following appears in the command shell: This script will configure the EMC Avamar DB2 plugin Enter path to Avamar Client installation [/usr/local/avamar]: 4. Type the full path to the Avamar client installation root directory and press Enter. The following appears in the command shell: Username for DB2 instance owner: db2dba where db2dba is the database instance owner. 5. Type the user account that owns this database instance and press Enter. The following appears in the command shell: Home directory for DB2 instance owner [/home/db2dba]: where /data02/db2qa is the home directory for the database instance owner. 6. Type the full path to the home directory of the user that owns this database instance and press Enter The following appears in the command shell: Writing /usr/local/avamar/etc/db2.cfg... Restarting client agent... avagent.d Info: Stopping Avamar Client Agent (avagent)... EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 20

21 Uninstalling the Avamar for DB2 Client on IBM AIX INSTALLATION AND CONFIGURATION avagent.d Info: Client Agent stopped. avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id avagent.d Info: Client Agent started. Uninstalling the Avamar for DB2 Client on IBM AIX User=root 1. Open a command shell and log in to the computer that hosts the DB2 server as root. 2. Uninstall the Avamar DB2 plug-in software by typing: lslpp -l grep Avamar The following appears in the command shell: AvamarClient-aix5-ppc VERSION COMMITTED EMC Avamar client VERSION AvamarDB2-aix5-ppc64 VERSION COMMITTED EMC Avamar client VERSION 3. Type: geninstall -u AvamarDB2-aix5-ppc64 The following appears in the command shell: Pre-deinstall Verification Verifying selections...done Verifying requisites...done Results... SUCCESSES Filesets listed in this section passed pre-deinstall verification and will be removed. Selected Filesets AvamarDB2-aix5-ppc # EMC Avamar client << End of Success Section >> FILESET STATISTICS Selected to be deinstalled, of which: 1 Passed pre-deinstall verification Total to be deinstalled Deinstalling Software installp: DEINSTALLING software for: AvamarDB2-aix5-ppc64 VERSION Finished processing all filesets. (Total time: 1 secs) Summaries: Installation Summary EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 21

22 Uninstalling the Avamar for DB2 Client on IBM AIX INSTALLATION AND CONFIGURATION Name Level Part Event Result AvamarDB2-aix5-ppc USR DEINSTALL SUCCESS 4. Uninstall the Avamar for AIX Client software by typing: lslpp -l grep Avamar The following appears in the command shell: AvamarClient-aix5-ppc VERSION COMMITTED EMC Avamar client VERSION 5. Type: geninstall -u AvamarClient-aix5-ppc The following appears in the command shell: Pre-deinstall Verification Verifying selections...avagent.d Info: Stopping Avamar Client Agent (avagent)... avagent.d Info: Client Agent stopped. done Verifying requisites...done Results... SUCCESSES Filesets listed in this section passed pre-deinstall verification and will be removed. Selected Filesets AvamarClient-aix5-ppc # EMC Avamar client << End of Success Section >> FILESET STATISTICS Selected to be deinstalled, of which: 1 Passed pre-deinstall verification Total to be deinstalled Deinstalling Software installp: DEINSTALLING software for: AvamarClient-aix5-ppc VERSION Finished processing all filesets. (Total time: 2 secs) Summaries: Installation Summary Name Level Part Event Result AvamarClient-aix5-ppc USR DEINSTALL SUCCESS EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 22

23 Installing the Avamar for DB2 Client on Microsoft Windows INSTALLATION AND CONFIGURATION Upgrading the Avamar for DB2 Client on IBM AIX To upgrade the Avamar for AIX Client and Avamar DB2 plug-in software, uninstall the old software and install the new software. Installing the Avamar for DB2 Client on Microsoft Windows Task list. To install the Avamar for DB2 Client on supported Microsoft Windows platforms: Install the Avamar for Windows Client (page 23) Register the Avamar for Windows Client (page 25) Install the Avamar Windows DB2 plug-in (page 26) Windows Server 2008 and 2008 R2 with User Account Control. In Windows Server 2008, Microsoft added the User Account Control (UAC) feature. UAC is designed to provide additional operating system security by preventing software from being installed with administrator privileges, unless an administrator authorizes the elevated privileges. Starting the Avamar for Windows Client installer with normal account privileges does not install the software correctly on a computer with a default implementation of UAC. Instead, run the installer with elevated administrative privileges to correctly install the software. This interim solution is included in the following installation procedures. Install the Avamar for Windows Client 1. Log in to the computer that hosts the DB2 server. 2. Open a web browser and type the following URL: where AVAMARSERVER is the Avamar system network hostname (as defined in DNS) or IP address. You are automatically redirected to the Avamar secure web server. 3. If a security alert dialog box appears due to browser security settings, click Yes or OK to allow redirection to the Avamar secure web server. The Secure Log On page appears. 4. Scroll down until the Downloads and Documents hyperlink is visible. 5. Click Downloads and Documents. The Downloads and Documentation page appears. 6. Click the correct operating system hyperlink for the client computer. A directory listing appears. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 23

24 7. Do one of the following: Installing the Avamar for DB2 Client on Microsoft Windows INSTALLATION AND CONFIGURATION IF You are installing on a 32-bit Microsoft Windows Server platform. You are installing on a 64-bit Microsoft Windows Server platform. DO THIS Select the AvamarClient-windowsx86-VERSION.msi install package. Select the AvamarClient-windowsx86_64-VERSION.msi install package. IMPORTANT: For computers with UAC, you must download the install package to a temporary directory. Do not open it in place. Windows Server 2008 and 2008 R2 with User Account Control (page 23) provides additonal information. 8. Start the installer using one of the methods in the following table. IF You are installing on a non-uac computer and want to run the installation file in place. You are installing on a non-uac computer and want to download and run the installation file. You are installing on a UAC computer. DO THIS Open the installation file in place on the server. Download the installation file to a temporary directory on the computer. 1. In Windows, right-click the Command Prompt icon and select Run as administrator. 2. In the command prompt window, change the working directory to the location of the installation package by typing: cd PATH-TO-INSTALL-DIR where PATH-TO-INSTALL-DIR is the full path of the temporary directory that contains the installation package. 3. On a single line, type the following command to launch the installer by typing: msiexec /i AvamarClient-windowsx86_64-VERSION.msi where VERSION is the version number of the available install package. The installation wizard appears. 9. Follow the instructions in the wizard. 10. Click Finish to complete the installation procedure. The Avamar client icon appears in the system tray. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 24

25 Register the Avamar for Windows Client Installing the Avamar for DB2 Client on Microsoft Windows INSTALLATION AND CONFIGURATION Before or restore files on the DB2 server, you must register it with the Avamar system. To register the client: 1. Right-click the Avamar client system tray icon. A menu appears. 2. Select Activate. The Activate Client Setup dialog box appears. 3. Type the following: FIELD Administrator Server Address Client Domain DESCRIPTION Administrator server network hostname as defined in DNS. Avamar domain where you want this client to reside. The default domain is clients. However, the Avamar system administrator may have defined other domains and subdomains. Consult the Avamar system administrator for the domain to use when registering this client. IMPORTANT: If entering a subdomain (for example, clients/windows), do not include a slash (/) as the first character. Including a slash as the first character causes an error and prevents you from registering this client. 4. Click OK. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 25

26 Install the Avamar Windows DB2 plug-in Installing the Avamar for DB2 Client on Microsoft Windows INSTALLATION AND CONFIGURATION 1. Log in to the computer that hosts the DB2 server. 2. Open a web browser and type the following URL: where AVAMARSERVER is the Avamar system network hostname (as defined in DNS) or IP address. You are automatically redirected to the Avamar secure web server. 3. If a security alert dialog box appears due to browser security settings, click Yes or OK to allow redirection to the Avamar secure web server. The Secure Log On page appears. 4. Scroll down until the Downloads and Documents hyperlink is visible. 5. Click Downloads and Documents. The Downloads and Documentation page appears. 6. Click the correct operating system hyperlink for the client computer. A directory listing appears. 7. Do one of the following: IF You are installing on a 32-bit Microsoft Windows Server platform. You are installing on a 64-bit Microsoft Windows Server platform. DO THIS Select the AvamarDB2-windows-x86- VERSION.msi install package. Select the AvamarDB2-windowsx86_64-VERSION.msi install package. 8. Either open the installation file in place (on the server) or double-click the downloaded installation file. The InstallShield Wizard appears. 9. Follow the instructions in the wizard. 10. Click Finish to complete the installation procedure. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 26

27 Uninstalling and upgrading the Avamar for DB2 Client on Microsoft Windows INSTALLATION AND CONFIGURATION Uninstalling and upgrading the Avamar for DB2 Client on Microsoft Windows You do not have to uninstall earlier versions of Avamar for DB2 Client software from Microsoft Windows before you install a new version. If you attempt to install the Avamar for DB2 Client on a server where it is already installed, you are prompted during installation whether to upgrade to the new version or remove the earlier version. If you decide to remove the old installation, you must rerun the installation file to install the new version. The current installation session becomes an uninstall session and then terminates. You can also use the Add/Remove Programs feature in the Windows Control Panel to uninstall the Avamar for DB2 Client. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 27

28 Installing the Avamar for DB2 Client on Red Hat Enterprise Linux Installing the Avamar for DB2 Client on Red Hat Enterprise Linux INSTALLATION AND CONFIGURATION Task list. To install the Avamar for DB2 Client on supported Red Hat Enterprise Linux platforms: Download Avamar Linux DB2 install packages (page 28) Install and register the Avamar for Linux Client (page 29) Install and Configure the Avamar DB2 Plug-In (page 30) Download Avamar Linux DB2 install packages 1. Log in to the computer on which to install this software. 2. Open a web browser and type the following URL: where AVAMARSERVER is the Avamar server network hostname (as defined in DNS) or IP address. You are automatically redirected to the Avamar secure web server. 3. If a security alert dialog box appears due to browser security settings, click Yes or OK to allow redirection to the Avamar secure web server. The Secure Log On page appears. 4. Scroll down until the Documents and Downloads hyperlink is visible. 5. Click Documents and Downloads. The Documents and Downloads page appears. 6. Click the correct operating system hyperlink for the client computer. A directory listing appears 7. Download the Avamar for Linux Client install package to a temporary install directory on the system. 8. Note the Avamar for Linux Client install package filename. 9. Download the Avamar DB2 plug-in install package to the same directory as the Avamar for Linux Client install package. 10. Note the Avamar DB2 plug-in install package filename. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 28

29 Installing the Avamar for DB2 Client on Red Hat Enterprise Linux INSTALLATION AND CONFIGURATION Install and register the Avamar for Linux Client User=root 1. Open a command shell and log in to the computer that hosts the DB2 server as root. 2. Install the Avamar for Linux Client software by typing: cd /tmp rpm -ivh AvamarClient-linux-rhel4-x86_64-VERSION.rpm where /tmp is the temporary install directory and AvamarClient-linuxrhel4-x86_64-VERSION.rpm is the Avamar for Linux Client install package that you downloaded (page 28). The following appears in the command shell: ########################################### [100%] ########################################### [100%] Installation complete You may run /usr/local/avamar/bin/avregister to register and activate this client with the Administrator server. avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id 2066 avagent.d Info: Client Agent started. 3. Register and activate this client with the Avamar server by typing: /usr/local/avamar/bin/avregister The following appears in the command shell: === Client Registration and Activation This script will register and activate the client with the Administrator server. Enter the Administrator server address (DNS text name or numeric IP address, DNS name preferred): 4. Type the network hostname (as defined in DNS) of the Avamar Administrator server and press Enter. The following appears in the command shell: Enter the Avamar server domain [clients]: The default domain is clients. However, the Avamar system administrator may have defined other domains and subdomains. Consult the Avamar system administrator for the domain to use when registering this client. IMPORTANT: If typing a subdomain (for example, clients/myclients), do not include a slash (/) as the first character. Including a slash as the first character causes an error and prevents you from registering this client. 5. Press Enter to accept the default domain (clients). The following appears in the command shell: avagent.d Info: Client Agent stopped. [ OK ] avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent.d Info: Client activated successfully. [ OK ] avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id 3385 avagent.d Info: Client Agent started. [ OK ] Registration Complete. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 29

30 Installing the Avamar for DB2 Client on Red Hat Enterprise Linux INSTALLATION AND CONFIGURATION Install and Configure the Avamar DB2 Plug-In IMPORTANT: You must Install and register the Avamar for Linux Client (page 29) before installing the Avamar DB2 plug-in. User=root 1. Ensure that you are still logged in to the computer that hosts the DB2 server as root. 2. Install the Avamar DB2 plug-in software by typing: cd /tmp rpm -ivh AvamarDB2-linux-rhel4-x86_64-VERSION.rpm where /tmp is the temporary install directory and AvamarDB2-linux-rhel4- x86_64-version.rpm is the Avamar for Linux Client install package that you downloaded (page 28). The following appears in the command shell: Preparing... ########################################### [100%] 1:AvamarDB2 ########################################### [100%] avagent Info: Stopping Avamar Client Agent (avagent)... avagent Info: Client Agent stopped. avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id avagent Info: Client Agent started. Installation complete You may run /usr/local/avamar/bin/avdb2setup to configure this module to backup to the dpn. 3. Configure the DB2 plug-in software by typing: /usr/local/avamar/bin/avdb2setup The following appears in the command shell: This script will configure the EMC Avamar DB2 plugin Enter path to Avamar Client installation [/usr/local/avamar]: 4. Type the full path to the Avamar client installation root directory and press Enter. The following appears in the command shell: Username for DB2 instance owner: db2dba where db2dba is the database instance owner. 5. Type the user account that owns this database instance and press Enter. The following appears in the command shell: Home directory for DB2 instance owner [/home/db2dba]: where /home/db2dba is the home directory for the database instance owner. 6. Type the full path to the home directory of the user that owns this database instance and press Enter The following appears in the command shell: Writing /usr/local/avamar/etc/db2.cfg... Restarting client agent... EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 30

31 Upgrading the Avamar for DB2 Client on Red Hat Enterprise Linux INSTALLATION AND CONFIGURATION avagent.d Info: Stopping Avamar Client Agent (avagent)... avagent.d Info: Client Agent stopped. avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id avagent.d Info: Client Agent started. Uninstalling and upgrading the Avamar for DB2 Client on Red Hat Enterprise Linux User=root 1. Open a command shell and log in to the computer that hosts the DB2 server as root. 2. List installed Avamar software by typing: rpm -qa grep Av The following appears in the command shell: AvamarClient-VERSION AvamarDB2-VERSION 3. Note the full package names. 4. Uninstall the Avamar DB2 plug-in by typing: rpm -e AvamarDB2-VERSION where AvamarDB2-VERSION is the Avamar DB2 plug-in install package returned in step 2. The following appears in the command shell: Removing the AvamarDB2 libraries avagent Info: Stopping Avamar Client Agent (avagent)... avagent Info: Client Agent stopped. avagent Info <5241>: Logging to /usr/local/avamar/var/avagent.log avagent Info <5417>: daemonized as process id avagent Info: Client Agent started. 5. Uninstall the Avamar for Linux Client by typing: rpm -e AvamarClient-VERSION where AvamarClient-VERSION is the Avamar software install package returned in step 2. The following appears in the command shell: avagent.d Info: Client Agent stopped. Upgrading the Avamar for DB2 Client on Red Hat Enterprise Linux To upgrade the Avamar for Linux Client and Avamar DB2 plug-in software, uninstall the old software and install the new software. Use of the Linux software upgrade command (rpm -Uh) is not supported. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 31

32 BACKUP This chapter describes how to use the Avamar for DB2 Client to back up an entire database. Database preparation This topic explains how to prepare the database for offline or online backups. Offline backups. To perform offline backups of a DB2 database, ensure that the no application is connected to the database when the operation begins and that no clients attempt to connect to the database for the duration of the backup operation. IMPORTANT: Ensure that no changes to the database are taking place during the backup window. Modifying a database in the middle of a backup can cause unpredictable application behavior, including failed backups. Online backups. Perform the following steps before you perform the first online backup of a DB2 database: 1. Type the following command on the DB2 server: db2 update db cfg for DATABASE-NAME using LOGRETAIN ON where DATABASE-NAME is the name of the database to back up. 2. Perform an offline backup of the DB2 database. The database is now in a state that supports future online backups. You must also select the Create an ONLINE backup option for the dataset or as an on-demand backup option. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 32

33 On-demand backup BACKUP On-demand backup The Avamar for DB2 Client offers three types of backups: Offline backups Online backups that contain archive logs Online backups without archive logs To perform an on-demand backup: 1. Prepare the database according to the instructions in Database preparation (page 32). 2. In Avamar Administrator, click the Backup & Restore launcher button. The Backup and Restore window appears. 3. Click the Select for Backup tab. 4. In the Clients tree, select the DB2 server to back up. 5. Leave the Browse for Files, Folders or Directories option selected. 6. In the tree, select the DB2 plug-in. 7. Click the DB2 instance folder. A list of databases appears to the right. 8. Select the database to back up. 9. Select Actions > Backup Now. The On Demand Backup Options dialog box appears. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 33

34 On-demand backup BACKUP 10. Select a retention setting for the backup. FIELD/OPTION Retention period End date No end date DESCRIPTION To automatically delete this backup from the Avamar server after a specific number of days, weeks, months, or years, select this option and type the number of days, weeks, months, or years. To automatically delete this backup from the Avamar server on a specific calendar date, select this option and browse to that date on the calendar. To keep this backup for as long as this client remains active in the Avamar server, select this option. 11. Select the encryption method for client/server data transfer during this backup. Choices are: High Medium None Strongest available encryption setting for that specific client platform. Medium strength encryption. No encryption. NOTE: The exact encryption technology and bit strength used for any given client/server connection is dependent on a number of factors, including the client platform and Avamar server version. The EMC Avamar Product Security Guide provides additional information. 12. Click More Options. The Backup Command Line Options dialog box appears. 13. Choose whether to perform an online or offline database backup by selecting or clearing the Create an ONLINE backup checkbox. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 34

35 On-demand backup BACKUP 14. If you are performing an online database backup, choose whether to include or exclude archive logs in the backup by selecting or clearing the Exclude archive logs in ONLINE backup checkbox. IMPORTANT: If you exclude archive logs from the database backup, ensure that archive logs files are included in filesystem backups. Failure to do so might result in loss of data. 15. Type the Instance Admin Username and Instance Admin Password. 16. Click OK to return to the On Demand Backup Options dialog box. 17. Click OK again. The On Demand Backup Options dialog box closes. 18. Click View Details to view details of the backup or click Close. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 35

36 Scheduling DB2 server backups BACKUP Scheduling DB2 server backups Task list. To back up the DB2 server on a regular schedule: Create a dataset for DB2 server backups (page 36). Set up scheduled DB2 server backups (page 39) by: Creating a dedicated group for DB2 backups. Adding the DB2 server to this new group. Assigning the new dataset to this new group. Assigning a schedule to this new group. Assigning a retention policy to this new group. Enable backups for the group (page 44). A thorough discussion of groups, group policy, datasets, schedules, and retention policies is beyond the scope of this publication. The EMC Avamar Administration Guide provides additional information. Creating a dataset for DB2 server backups 1. Start Avamar Administrator and log in to the root domain as an administrative user. 2. Select Tools > Manage Datasets. 3. The Manage All Datasets window appears. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 36

37 Scheduling DB2 server backups BACKUP 4. Click New. The New Dataset dialog box appears. 5. Type a name for the dataset. IMPORTANT: Do not use any of the following characters in the dataset name: asterisk (*), forward slash (/), backward slash (\), colon (:), semicolon (;), question mark (?), greater-than sign (>), less-than sign (<), or vertical bar ( ). 6. Click the Source Data tab. 7. Select Enter Explicitly. 8. Select the correct DB2 plug-in from the Select Plug-In Type list. 9. Click... The Select Files And/Or Folders dialog box appears. 10. In the Clients tree, select the DB2 server. 11. Select the DB2 plug-in. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 37

38 12. Select the database to back up with this dataset. Scheduling DB2 server backups BACKUP 13. Click OK. The Select Files And/Or Folders dialog box closes. The remaining dialog box tabs are used to set optional parameters such as exclude and include list entries and optional plug-in commands. However, the DB2 plug-in does not support include or exclude lists in datasets. 14. Click the Options tab. 15. Choose whether to perform an online or offline database backup by selecting or clearing the Create an ONLINE backup checkbox. 16. If you are performing an online database backup, choose whether to include or exclude archive logs in the backup by selecting or clearing the Exclude archive logs in ONLINE backup checkbox. IMPORTANT: If you do not include archive logs in the database backup, ensure that archive logs files are included in file system backups. Failure to do so might result in loss of data. 17. Type the Instance Admin Username and Instance Admin Password. 18. Click OK. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 38

39 Setting up scheduled DB2 server backups 1. In Avamar Administrator, click the Policy launcher button. The Policy window appears. Scheduling DB2 server backups BACKUP 2. Select Actions > New Group. The New Group wizard appears. 3. Select or type the information in the following table. FIELD/OPTION Name DESCRIPTION Type a name for the group. IMPORTANT: Do not use any of the following characters in the group name: asterisk (*), forward slash (/), backward slash (\), colon (:), semicolon (;), question mark (?), greater-than sign (>), less-than sign (<), or vertical bar ( ). EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 39

40 Scheduling DB2 server backups BACKUP FIELD/OPTION Disabled Encryption Method DESCRIPTION This option is selected by default. Clear this option to immediately use this group to take regularly scheduled client backups. This is the group encryption method that is used by all members of this group for client/server network communications unless it is overridden at the client level. Choices are: High Medium None Strongest available encryption setting for that specific client platform. Medium strength encryption. No encryption. NOTE: The exact encryption technology and bit strength used for any given client-server connection is dependent on a number of factors, including the client platform and Avamar server version. The EMC Avamar Product Security Guide provides additional information. Override Schedule Domain Select this option to override the assigned schedule for this group. You can also skip the next scheduled backup entirely (Skip Next Backup) or perform the next scheduled backup one time only (Run Next Backup Once). Location in the Avamar server where this group should reside. The remaining wizard screens are used to select a dataset, schedule, and retention policy, as well as build a client list for this group. You can click Finish at any time. Doing so causes the new group to be created using system default settings and an empty client list. You can change those settings by editing the group properties. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 40

41 Scheduling DB2 server backups BACKUP 4. Click Next. The next New Group wizard screen appears. 5. Select the dataset that you defined for the group during Creating a dataset for DB2 server backups (page 36) from the Select an Existing Dataset list. 6. Click Next. The next New Group wizard screen appears. 7. Select a schedule for the group from the Select an Existing Schedule list. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 41

42 Scheduling DB2 server backups BACKUP NOTE: You cannot edit schedules in this screen. Detailed schedule properties are shown so that you can review them before you make a selection. The EMC Avamar Administration Guide provides information about editing schedule properties. 8. Click Next. The next New Group wizard screen appears. 9. Select a retention policy for the group from the Select an Existing Retention Policy list. NOTE: You cannot edit retention policies in this screen. Detailed retention policy properties are shown so that you can review them before you make a selection. The EMC Avamar Administration Guide provides information about editing retention policy properties. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 42

43 Scheduling DB2 server backups BACKUP 10. Click Next. The final New Group wizard screen appears. This screen is used to build a list of clients that are members of the group. In this case, the group contains only one client, the DB2 server. 11. Select the DB2 server from the client list. 12. Click Finish. The New Group wizard closes and the new group appears in the Policy window. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 43

44 Enabling scheduled DB2 server backups Scheduling DB2 server backups BACKUP 1. Start Avamar Administrator and log in to the root domain as an administrative user. 2. Click the Policy launcher button. The Policy window appears. 3. Click the Policy Management tab. 4. Click the Groups tab. 5. Select the group that you created in the previous procedure (the group that now contains only the DB2 server). 6. Select Actions > Group > Disable Group. This clears the Disable Group option on the Actions > Group menu. A confirmation message appears. 7. Click Yes to enable this group. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 44

45 RESTORE AND RECOVERY This chapter describes how to use the Avamar for DB2 Client to restore an entire database, and roll the database forward (recover it) to: The end of the backup (available only for backups of DB2 9.5 databases and later) The end of the logs A specific point in time Database preparation To perform offline restores of a DB2 database, ensure that the database is idle when the operation begins and that no clients attempt to connect to the database for the duration restore operation. Restore overview The procedure that you use to restore a DB2 database from Avamar backups depends on the type of backup used to back up the database: Restoring from an offline backup (page 47) Restoring from an online backup with archive logs (page 50) Restoring from an online backup without archive logs (page 59) You can restore the database to its original location or to a different location (also known as "redirected restore"). In each of these scenarios, you must first locate and select the correct backup in the system (page 46), and then perform the correct restore procedure. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 45

46 Locating and selecting a backup RESTORE AND RECOVERY Locating and selecting a backup Before you can perform any restore procedure, you must locate and select the correct backup in the system. 1. In Avamar Administrator, click the Backup & Restore launcher button. The Backup and Restore window appears. 2. Click the Select for Restore tab. 3. In the Clients tree, select the DB2 server. 4. Click the By Date tab. A browsable calendar appears for locating backups in the Avamar server. 5. In the Backup History pane, browse to a valid backup date in the calendar. Dates highlighted in yellow indicate that a backup was performed on that date. 6. Select a backup from the backups list to the right of the calendar. The contents list below the Backup History pane is populated. 7. Click the DB2 instance folder. A list of database backups appears to the right. The prefix in the filename for a database backup indicates the type of backup, as discussed in the following table. TYPE OF BACKUP FILENAME PREFIX EXAMPLE FILENAME Offline c- c-db-name Online with archive logs hl- hl-db-name Online without archive logs h- h-db-name 8. Select the database backup to restore. If you are restoring one or more databases to their original locations, then you can select more than one database. However, if you are restoring the database to a different location (that is, redirected restore), then you can select only one database. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 46

47 Restoring from an offline backup RESTORE AND RECOVERY Restoring from an offline backup 1. Locate and select the offline backup in the system, as discussed in Locating and selecting a backup (page 46). This database is prefixed with "c-." For example: c-db-name. 2. Select Actions > Restore Now. The Restore Options dialog box appears. 3. Do one of the following: IF You are restoring one or more databases to their original location. You are restoring the database to a different location (that is, redirected restore). DO THIS Select Restore everything to its original location. Select Restore everything to a different location. IMPORTANT: If performing a redirected restore, the restore target directory must be on the same client from which the backup was originally taken. Restores to other clients are not supported. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 47

48 Restoring from an offline backup RESTORE AND RECOVERY 4. If you selected Restore everything to a different location in step 3, then browse the filesystem to specify the location for the restored database in the Absolute Destination field and do one of the following: IF You are restoring to a Windows DB2 client You are restoring to an AIX or Linux DB2 client DO THIS In the Absolute Destination field, type the drive letter where you want to restore the database. For example, C:\. During the restore, DB2 creates the following directory structure and restores the database to it: DRIVE\INSTANCE\NODE where DRIVE is the drive letter entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. In the Absolute Destination field, type the full path to the directory where you want to restore the database. For example, /home/db2inst/ or /local/databases. The directory should have the same owner and group attributes as the database owner. During the restore, DB2 creates the following directory structure and restores the database to it: PATH/INSTANCE/NODE where PATH is the path entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 48

49 5. Click More Options. The Restore Command Line Options dialog box appears. Restoring from an offline backup RESTORE AND RECOVERY 6. Select the Restore Only option. 7. Type the Instance Admin Username and Instance Admin Password. 8. If you selected Restore everything to a different location in step 3, type a new name for the database in the Database Name field. Otherwise, leave this field emtpy. 9. Click OK. The Restore Command Line Options dialog box closes. 10. Switch to the Restore Options dialog box and click OK. The Restore Options dialog box closes. 11. Click View Details to view details of the restore or click Close. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 49

50 Restoring from an online backup with archive logs RESTORE AND RECOVERY Restoring from an online backup with archive logs If you have an online backup that contains archive logs, then you can restore both the database and the archive logs, and automatically roll the database forward (recover it) to: The end of the backup (available only for backups of DB2 9.5 databases and later) The end of the logs A specific point in time Alternatively, you can restore only the database or only the archive logs. Restoring and recovering the database To restore both the database and the archive logs, and automatically roll the database forward (recover it): 1. Locate and select the correct online backup that contains archive logs, as discussed in Locating and selecting a backup (page 46). This database is prefixed with "hl-." For example: hl-db-name. 2. Select Actions > Restore Now. The Restore Options dialog box appears. 3. Do one of the following: IF You are restoring one or more databases to their original location. You are restoring the database to a different location (that is, redirected restore). DO THIS Select Restore everything to its original location. Select Restore everything to a different location. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 50

51 Restoring from an online backup with archive logs RESTORE AND RECOVERY IMPORTANT: If performing a redirected restore, the restore target directory must be on the same client from which the backup was originally taken. Restores to other clients are not supported. 4. If you selected Restore everything to a different location in step 3, then browse the filesystem to specify the location for the restored database in the Absolute Destination field and do one of the following: IF You are restoring to a Windows DB2 client You are restoring to an AIX or Linux DB2 client DO THIS In the Absolute Destination field, type the drive letter where you want to restore the database. For example, C:\. During the restore, DB2 creates the following directory structure and restores the database to it: DRIVE\INSTANCE\NODE where DRIVE is the drive letter entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. In the Absolute Destination field, type the full path to the directory where you want to restore the database. For example, /home/db2inst/ or /local/databases. The directory should have the same owner and group attributes as the database owner. During the restore, DB2 creates the following directory structure and restores the database to it: PATH/INSTANCE/NODE where PATH is the path entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 51

52 Restoring from an online backup with archive logs RESTORE AND RECOVERY 5. Click More Options. The Restore Command Line Options dialog box appears. 6. Select the Restore and Recover option. 7. From the Type of Recovery list, choose the point to recover to. IFRECOVERING TO The end of the backup (DB2 9.5 and later) The end of the archive logs A specific point in time DO THIS Select End of Backup. Select End of logs. Select Point In Time, Then type a valid recovery date and time in the Date and Time field using yyyymm-dd hh:mm:ss format. Time should be in the time zone of the client system. The entry can be truncated to the desired precision level. For example, minutes and seconds can be omitted for convenience. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 52

53 Restoring from an online backup with archive logs RESTORE AND RECOVERY 8. In the Directory path to restore archive logs field, type the full path of a top-level destination directory (folder) to which to restore the archive logs. The restore operation automatically creates a subdirectory at this location to which the archive logs are written. This new subdirectory is named: BACKUP-IMAGE-NAME-TIMESTAMP where BACKUP-IMAGE-NAME and TIMESTAMP are the backup image name and restore timestamp, respectively. NOTE: Specify the path to which to restore the archive logs even if you select the Restore and Recover option. 9. Type the Instance Admin Username and Instance Admin Password. 10. If you selected Restore everything to a different location in step 3, type a new name for the database in the Database Name field. 11. Click OK. The Restore Command Line Options dialog box closes. 12. Switch to the Restore Options dialog box and click OK. The Restore Options dialog box closes. 13. Click View Details to view details of the restore or click Close. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 53

54 Restoring from an online backup with archive logs RESTORE AND RECOVERY Restoring only the database 1. Locate and select the correct online backup that contains archive logs, as discussed in Locating and selecting a backup (page 46). This database is prefixed with "hl-." For example: hl-db-name. 2. Select Actions > Restore Now. The Restore Options dialog box appears. 3. Do one of the following: IF You are restoring one or more databases to their original location. You are restoring the database to a different location (that is, redirected restore). DO THIS Select Restore everything to its original location. Select Restore everything to a different location. IMPORTANT: If performing a redirected restore, the restore target directory must be on the same client from which the backup was originally taken. Restores to other clients are not supported. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 54

55 Restoring from an online backup with archive logs RESTORE AND RECOVERY 4. If you selected Restore everything to a different location in step 3, then browse the filesystem to specify the location for the restored database in the Absolute Destination field and do one of the following: IF You are restoring to a Windows DB2 client You are restoring to a AIX or Linux DB2 client DO THIS In the Absolute Destination field, type the drive letter where you want to restore the database. For example, C:\. During the restore, DB2 creates the following directory structure and restores the database to it: DRIVE\INSTANCE\NODE where DRIVE is the drive letter entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. In the Absolute Destination field, type the full path to the directory where you want to restore the database. For example, /home/db2inst/ or /local/databases. The directory should have the same owner and group attributes as the database owner. During the restore, DB2 creates the following directory structure and restores the database to it: PATH/INSTANCE/NODE where PATH is the path entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. 5. Click More Options. The Restore Command Line Options dialog box appears. 6. Select the Restore Only option. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 55

56 Restoring from an online backup with archive logs RESTORE AND RECOVERY 7. Type the Instance Admin Username and Instance Admin Password. 8. If you selected Restore everything to a different location in step 3, type a new name for the database in the Database Name field. 9. Click OK. The Restore Command Line Options dialog box closes. 10. Switch to the Restore Options dialog box and click OK. The Restore Options dialog box closes. 11. Click View Details to view details of the restore or click Close. 12. Wait for the restore to complete. 13. Restore the archive logs from a filesystem backup to the SQLOGDIR directory (that is, the directory location stored by the DB2 SQLOGDIR variable). 14. Manually roll the database forward to the desired point in time by issuing a rollforward command on the DB2 server. This is an example of a command that rolls the database forward to the end of the archive logs (it applies all the logs): db2 rollforward db DB-NAME to end of logs and complete where DB-NAME is the database name. If the rollforward operation is not executed, subsequent backup and restore operations involving the Avamar DB2 plug-in fail with an error message advising that the database must be rolled forward. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 56

57 Restoring only the archive logs Restoring from an online backup with archive logs RESTORE AND RECOVERY If you have an online backup that contains archive logs, you can restore only the archive logs (not the database). To restore only the archive logs from an online backup: 1. Locate and select the correct online backup that contains archive logs, as discussed in Locating and selecting a backup (page 46). This database is prefixed with "hl-." For example: hl-db-name. 2. Select Actions > Restore Now. The Restore Options dialog box appears. 3. Do one of the following: IF You are restoring the archive logs to their original location. You are restoring the archive logs to a different location (that is, redirected restore). DO THIS Select Restore everything to its original location. Select Restore everything to a different location. IMPORTANT: If performing a redirected restore, the restore target directory must be on the same client from which the backup was originally taken. Restores to other clients are not supported. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 57

58 Restoring from an online backup with archive logs RESTORE AND RECOVERY 4. If you selected Restore everything to a different location in step 3, then browse the filesystem to specify the full path of a top-level destination directory (folder) to which to restore the archive logs. The restore operation automatically creates a subdirectory at this location to which the archive logs are written. This new subdirectory is named: BACKUP-IMAGE-NAME-TIMESTAMP where BACKUP-IMAGE-NAME and TIMESTAMP are the backup image name and restore timestamp, respectively. 5. Click More Options. The Restore Command Line Options dialog box appears. 6. Select the Restore only archive logs from ONLINE backup option. 7. If you selected Restore everything to its original location in step 3, then in the Directory path to restore archive logs field, type the full path of a top-level destination directory (folder) to which to restore the archive logs. The restore operation automatically creates a subdirectory at this location to which the archive logs are written. This new subdirectory is named: BACKUP-IMAGE-NAME-TIMESTAMP where BACKUP-IMAGE-NAME and TIMESTAMP are the backup image name and restore timestamp, respectively. 8. Type the Instance Admin Username and Instance Admin Password. 9. Click OK. The Restore Command Line Options dialog box closes. 10. Switch to the Restore Options dialog box and click OK. The Restore Options dialog box closes. 11. Click View Details to view details of the restore or click Close. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 58

59 Restoring from an online backup without archive logs RESTORE AND RECOVERY Restoring from an online backup without archive logs If you have an online backup that does not contain archive logs, then you can restore the database and then manually roll the database forward to the desired point in time by issuing a rollforward command on the DB2 server. To restore from an online backup without archive logs: 1. Locate and select the correct online backup without archive logs, as discussed in Locating and selecting a backup (page 46). This database is prefixed with "h-." For example: h-db-name. 2. Select Actions > Restore Now. The Restore Options dialog box appears. 3. Do one of the following: IF You are restoring one or more databases to their original location. You are restoring the database to a different location (that is, redirected restore). DO THIS Select Restore everything to its original location. Select Restore everything to a different location. IMPORTANT: If performing a redirected restore, the restore target directory must be on the same client from which the backup was originally taken. Restores to other clients are not supported. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 59

60 Restoring from an online backup without archive logs RESTORE AND RECOVERY 4. If you selected Restore everything to a different location in step 3, then browse the filesystem to specify the location for the restored database in the Absolute Destination field and do one of the following: IF You are restoring to a Windows DB2 client You are restoring to a AIX or Linux DB2 client DO THIS In the Absolute Destination field, type the drive letter where you want to restore the database. For example, C:\. During the restore, DB2 creates the following directory structure and restores the database to it: DRIVE\INSTANCE\NODE where DRIVE is the drive letter entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. In the Absolute Destination field, type the full path to the directory where you want to restore the database. For example, /home/db2inst/ or /local/databases. The directory should have the same owner and group attributes as the database owner. During the restore, DB2 creates the following directory structure and restores the database to it: PATH/INSTANCE/NODE where PATH is the path entered in the Absolute Destination field, INSTANCE is the database instance name, and NODE is the database node name. 5. Click More Options. The Restore Command Line Options dialog box appears. 6. Select the Restore Only option. EMC AVAMAR 6.0 FOR IBM DB2 GUIDE 60