VERITAS NetBackup 6.0 for SAP

VERITAS NetBackup 6.0 for SAP System Administrator s Guide for UNIX and Linux N15265B September 2005

Disclaimer The information contained in this publication is subject to change without notice. VERITAS Software Corporation makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. VERITAS Software Corporation shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual. VERITAS Legal Notice Copyright 2005 VERITAS Software Corporation. All rights reserved. VERITAS, the VERITAS Logo, and NetBackup are trademarks or registered trademarks of VERITAS Software Corporation or its affiliates in the U.S. and other countries. Other names may be trademarks of their respective owners. Portions of this software are derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm. Copyright 1991-92, RSA Data Security, Inc. Created 1991. All rights reserved. VERITAS Software Corporation 350 Ellis Street Mountain View, CA 94043 USA Phone 650-527-8000 Fax 650-527-2908 www.veritas.com Third-Party Copyrights For a list of third-party copyrights, see the NetBackup Release Notes appendix. ii NetBackup for SAP System Administrator s Guide for UNIX and Linux

Contents Preface.............................................................. ix Getting Help.............................................................. ix Finding NetBackup Documentation....................................... ix Accessing the VERITAS Technical Support Web Site.......................... x Contacting VERITAS Licensing........................................... xi Accessibility Features...................................................... xi Comment on the Documentation............................................xii Chapter 1. Introduction..................................................1 NetBackup for SAP Features................................................. 2 NetBackup for SAP Overview................................................ 4 Technical Overview...................................................... 4 Sequence of Operation.................................................... 6 NetBackup for SAP on Oracle Databases.................................... 6 Using NetBackup for SAP on Oracle Databases Without RMAN............ 7 Using NetBackup for SAP on Oracle Databases With RMAN............... 7 SAP Tools Overview.................................................. 9 NetBackup for SAP on MaxDB Databases.................................. 10 Chapter 2. Installation..................................................11 Verifying the Installation Prerequisites....................................... 11 Operating System and Platform Compatibility.............................. 11 NetBackup Software.................................................... 12 Database Software...................................................... 12 iii

Cluster Software....................................................... 13 Installing NetBackup for SAP............................................... 14 Remote Installation of NetBackup for SAP................................. 14 Loading the NetBackup for SAP Files onto the Server.................... 14 Pushing the Software to All Clients Currently Specified in an SAP Policy Type 17 Pushing the Software to New or Selected Clients......................... 20 Local Installation of NetBackup for SAP................................... 22 Linking NetBackup for SAP with backint (Oracle Databases without RMAN Only)..................................... 25 Linking the Oracle Database with the SBT Library (Oracle Databases with RMAN Only)........................................ 26 Chapter 3. Configuration............................................... 27 User Interface Terminology Notes........................................... 27 Configuring the Maximum Jobs Per Client.................................... 28 Configuring Backup Policies................................................ 30 Adding a New Policy................................................... 30 Description of Attributes............................................. 31 Adding Schedules...................................................... 32 Types of Backup Schedules........................................... 34 Schedule Properties.................................................. 35 Adding Clients......................................................... 37 Adding Backup Selections............................................... 38 Creating Scripts........................................................... 40 Modifying the Backup Scripts............................................ 41 Script Parameters....................................................... 43 Modifying the Configuration Files........................................... 44 Files to Configure...................................................... 44 Relationships Between Files.............................................. 44 Modifying the initsid.utl File............................................ 45 iv NetBackup for SAP System Administrator s Guide for UNIX and Linux

Modifying the initsid.sap File (NetBackup for SAP on Oracle Databases Only)............................. 47 Modifying the bsi.env File (NetBackup for SAP on MaxDB Databases)................................. 50 Testing Configuration Settings.............................................. 53 Testing Multiple Drives and Files............................................ 53 Chapter 4. Using NetBackup for SAP.....................................55 Performing a Backup.......................................................56 Method 1: Using NetBackup for SAP to Perform a Backup................... 56 Automatic Backup................................................... 56 Manual Backup...................................................... 56 Method 2: Using SAP to Perform a Backup (NetBackup for SAP on Oracle Databases Only)............................. 56 SAPDBA Offline Backup.............................................. 58 brbackup Online Backup.............................................. 62 Performing an Archive.....................................................64 Method 1: Using the NetBackup Multiple Copies Feature.................... 64 Examples........................................................... 64 Method 2: Using Two brarchive Commands in Sequence..................... 64 Examples........................................................... 64 Performing a Restore....................................................... 66 Using the SAPDBA Utility (NetBackup for SAP on Oracle Databases Only)............................. 66 Redirecting a Restore to a Different Client (NetBackup for SAP on Oracle Databases Only)............................. 66 Redirected Restore Sample Environment................................ 69 Chapter 5. NetBackup for SAP on MaxDB Databases........................71 Configuration............................................................. 71 Creating a Backup Medium................................................. 71 Using NetBackup for SAP on a MaxDB Database to Perform Backups and Restores. 72 Contents v

Performing a Backup................................................... 73 Performing a Query.................................................... 73 Performing a Restore................................................... 74 Performing Backups and Restores Using Parallel Medium Groups............ 74 Chapter 6. Troubleshooting............................................ 77 Setting the Debug Level.................................................... 78 NetBackup Reports........................................................ 78 Enabling Logging...................................................... 78 Accessing the Log Files.................................................. 79 bphdb Directory on the Client......................................... 79 backint Directory on the Client...................................... 80 NetBackup Server Reports............................................... 80 sapdba Logs and Messages................................................. 80 Backup and Restore Log Files............................................ 80 Archive Log Files....................................................... 81 Minimizing Timeout Failures on Large Database Restores...................... 82 Appendix A. backint Command Line..................................... 83 Appendix B. backint -i in_file Contents................................... 87 Appendix C. backint -o out_file Contents................................. 89 Information Returned for a Backup.......................................... 89 Information Returned for a Restore.......................................... 89 Information Returned for an Inquiry......................................... 89 Appendix D. Environment Variables..................................... 91 Appendix E. bp.conf File............................................... 93 Appendix F. Parameters Used in initsid.utl............................... 95 vi NetBackup for SAP System Administrator s Guide for UNIX and Linux

backint_dir work_directory.......................................... 97 backup_stream_buffersize size....................................... 98 bplist_filter script_path............................................ 98 client client_machine_name.......................................... 99 custom_sort_file file_path.......................................... 99 drives number_of_drives............................................. 101 fail_backup........................................................... 102 inquiry_query_period months......................................... 102 master_time_offset minutes......................................... 102 media_notify_script script_path................................... 103 policy policy_name................................................... 103 policy2 policy_name.................................................. 103 restore_filter script_path......................................... 104 restore_stream_buffersize size..................................... 105 retry_backup number_of_retries..................................... 105 schedule schedule_name.............................................. 105 schedule2 schedule_name............................................. 105 server server_name................................................... 106 sleep seconds......................................................... 106 sort_backup_type value.............................................. 106 sort_backup_type custom.......................................... 107 sort_backup_type device.......................................... 107 sort_backup_type drive........................................... 108 sort_backup_type size (Default).................................... 109 sort_restore_type value............................................. 111 sort_restore_type custom......................................... 111 sort_restore_type drive.......................................... 111 sort_restore_type image (Default).................................. 112 switch_list control_file_path...................................... 113 switch_log control_file_path....................................... 114 Contents vii

switch_sem control_file_path....................................... 114 Appendix G. Using NetBackup for SAP to Back Up SAPDB................. 115 Creating Backup Environment Configuration Files............................ 115 backint for SAPDB Configuration File.................................. 116 Adapter Program Configuration File..................................... 117 NetBackup for SAP Configuration File, initsid.utl......................... 118 Defining a Backup Medium in SAPDB...................................... 119 Performing a Backup..................................................... 119 Performing a Restore..................................................... 120 Index.............................................................. 121 viii NetBackup for SAP System Administrator s Guide for UNIX and Linux

Preface This guide describes how to install, configure, and use NetBackup for SAP on UNIX and Linux platforms. Throughout the NetBackup for SAP documentation, the term UNIX refers to both UNIX and Linux platforms. For information about the NetBackup server software, see one of the following platform-specific manuals: NetBackup System Administrator s Guide for UNIX and Linux, Volumes I and II NetBackup System Administrator s Guide for Windows, Volumes I and II Getting Help You can find answers to questions and get help from the NetBackup documentation and from the VERITAS technical support web site. Finding NetBackup Documentation A list of the entire NetBackup documentation set appears as an appendix in the NetBackup Release Notes. All NetBackup documents are included in PDF format on the NetBackup Documentation CD. For definitions of NetBackup terms, consult the online glossary. To access the NetBackup online glossary 1. In the NetBackup Administration Console, click Help > Help Topics. 2. Click the Contents tab. 3. Click Glossary of NetBackup Terms. Use the scroll function to navigate through the glossary. ix

Getting Help Accessing the VERITAS Technical Support Web Site The address for the VERITAS Technical Support Web site is http://support.veritas.com. The VERITAS Support Web site lets you do any of the following: Obtain updated information about NetBackup for SAP, including system requirements, supported platforms, and supported peripherals Contact the VERITAS Technical Support staff and post questions to them Get the latest patches, upgrades, and utilities View the NetBackup for SAP Frequently Asked Questions (FAQ) page Search the knowledge base for answers to technical support questions Receive automatic notice of product updates Find out about NetBackup for SAP training Read current white papers related to NetBackup for SAP From http://support.veritas.com, you can complete various tasks to obtain specific types of support for NetBackup for SAP: 1. Subscribe to the VERITAS Email notification service to be informed of software alerts, newly published documentation, Beta programs, and other services. a. From the main http://support.veritas.com page, select a product family and a product. b. Under Support Resources, click Email Notifications. Your customer profile ensures you receive the latest VERITAS technical information pertaining to your specific interests. 2. Locate the telephone support directory at http://support.veritas.com by clicking the Phone Support icon. A page appears that contains VERITAS support numbers from around the world. Note Telephone support for NetBackup for SAP is only available with a valid support contract. To contact VERITAS for technical support, dial the appropriate phone number listed on the Technical Support Guide included in the product box and have your product license information ready for quick navigation to the proper support group. 3. Contact technical support using e-mail. x NetBackup for SAP System Administrator s Guide for UNIX and Linux

Accessibility Features a. From the main http://support.veritas.com page, click the E-mail Support icon. A wizard guides you to do the following: Select a language of your preference Select a product and a platform Provide additional contact and product information, and your message Associate your message with an existing technical support case b. After providing the required information, click Send Message. Contacting VERITAS Licensing For license information, you can contact us as follows: Call 1-800-634-4747 and select option 3 Fax questions to 1-650-527-0952 In the Americas, send e-mail to amercustomercare@veritas.com. In the Asia and Pacific areas, send email to apaccustomercare@veritas.com. In all other areas, send email to internationallicense@veritas.com. Accessibility Features NetBackup contains features that make the user interface easier to use by people who are visually impaired and by people who have limited dexterity. Accessibility features include: Support for assistive technologies such as screen readers and voice input (Windows servers only) Support for keyboard (mouseless) navigation using accelerator keys and mnemonic keys For more information, see the NetBackup Installation Guide. Preface xi

Comment on the Documentation Comment on the Documentation Let us know what you like and dislike about the documentation. Were you able to find the information you needed quickly? Was the information clearly presented? You can report errors and omissions or tell us what you would find useful in future versions of our manuals and online help. Please include the following information with your comment: The title and product version of the manual on which you are commenting The topic (if relevant) on which you are commenting Your comment Your name Email your comment to NBDocs@veritas.com. Please only use this address to comment on product documentation. See Getting Help in this preface for information on how to contact Technical Support about our software. We appreciate your feedback. xii NetBackup for SAP System Administrator s Guide for UNIX and Linux

Introduction 1 NetBackup for SAP integrates the database backup and recovery capabilities of SAP with the backup and recovery management capabilities of NetBackup. NetBackup for SAP supports SAP environments based on the following databases: Oracle databases. In an Oracle environment, you can use the Oracle database either with or without the recovery manager (RMAN). SAP DB and MaxDB TM databases. This documentation describes using NetBackup for SAP with both SAP DB and MaxDB databases. For readability, the remainder of this manual uses only the term MaxDB to describe these database platforms. The SAP DB name refers to the 7.4 and earlier releases. The MaxDB name refers to the 7.5 and later releases. This chapter explains the differences and similarities between using NetBackup for SAP in each environment. For example, one major difference is that the SAP tools are supported only for Oracle databases. This chapter includes the following topics: NetBackup for SAP features NetBackup for SAP overview Note This manual differentiates between SAP on an Oracle database and SAP on a MaxDB database only when necessary to explain differences between using NetBackup for SAP with these specific databases. For most tasks, NetBackup for SAP operates the same way in each environment. 1

NetBackup for SAP Features NetBackup for SAP Features The following list shows NetBackup for SAP s main features and introduces some terms used in the NetBackup for SAP documentation. For more information on general NetBackup terminology, see the NetBackup System Administration Guide, Volume I. Feature Media and device management Scheduling facilities Multiplexed backups and restores Transparent execution of both SAP and regular file system backup and restore operations Sharing the same Media Manager and disk storage units used for other file backups Centralized and networked backup operations Description All devices supported by Media Manager are available to NetBackup for SAP. NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended SAP backups. This also lets you choose the times when these operations can occur. For example, to prevent interference with normal daytime operations, you can schedule your database backups to occur only at night. NetBackup for SAP lets you take advantage of NetBackup s multiplexing capabilities. Multiplexing directs multiple data streams to one backup device, thereby reducing the time necessary to complete the operation. All backups and restores run simultaneously and transparently without any action from the NetBackup administrator. The database administrator can run database backup and restore operations through NetBackup. Alternatively, if you are using NetBackup for SAP on an Oracle database, you can use SAP Tools as if NetBackup were not present. An administrator or any other authorized user can use NetBackup to run database backups and restores. It is possible to share the same devices and media used for other backups or to give SAP exclusive use of certain devices and media. From the NetBackup master server, you can schedule database backups or start them manually for any client. The SAP databases can also reside on hosts that are different from the devices on which NetBackup stores the backups. 2 NetBackup for SAP System Administrator s Guide for UNIX and Linux

NetBackup for SAP Features Feature Graphical user interfaces Parallel backup and restore operations Description NetBackup provides the following graphical user interfaces for client users and administrators: NetBackup Administration Console for Java NetBackup Administration Console for Windows A database administrator or NetBackup administrator can start backup or restore operations for SAP from the NetBackup graphical user interface on the master server. NetBackup for SAP supports the parallel backup and restore capabilities of the SAP Tools. For example, this permits the user to run more than one tape device at a time for a single SAP backup or restore, thereby reducing the time necessary to complete the operation. Chapter 1, Introduction 3

NetBackup for SAP Overview NetBackup for SAP Overview The following sections provide a technical overview and explain the sequence of operation for NetBackup for SAP. Technical Overview The following example network shows the major components in a NetBackup for SAP configuration. The server that is hosting the Oracle or the MaxDB database must be a NetBackup client, and it must have NetBackup for SAP installed. NetBackup for SAP Environment on an Oracle or MaxDB Database System hosting the Oracle or MaxDB database Oracle or MaxDB database NetBackup for SAP supplies: backint Interface Sample script files Additional required NetBackup software: NetBackup Client Network (TCP/IP) NetBackup master server or remote media server Media Manager or disk storage unit NetBackup software: NetBackup Master Server NetBackup Media Server (if system is a media server) NetBackup for SAP assumes either an Oracle or a MaxDB database as the underlying database. The following additional components are present depending on the underlying database: 4 NetBackup for SAP System Administrator s Guide for UNIX and Linux

NetBackup for SAP Overview In an Oracle environment, the SAP tools perform database-related tasks. The brbackup, brarchive, and brrestore utilities communicate with NetBackup through the NetBackup for SAP backint interface. The sapdba component of SAP tools accesses the backup catalog used by NetBackup in order to determine the status of the valid backups. In a MaxDB environment, you initiate backups and restores through the MaxDB administrative interface. This interface can be the Database Manager Graphical User Interface (DBM GUI), the Database Manager Command Line Interface (DBM CLI), and the Web Database Manager (Web DBM). Chapter 1, Introduction 5

NetBackup for SAP Overview Sequence of Operation NetBackup users or schedules start database backups or restores by selecting an SAP script. A NetBackup process called bphdb starts the SAP script on the client if the backup is initiated by a policy on the master server. The SAP application then starts the requested operation on the databases. The following figure shows the sequence of operation: NetBackup for SAP Operations Database Files SAP Tools or MaxDB Administrative Interface (DBM CLI) NetBackup for SAP backint NetBackup XBSA API Script Command Line NetBackup Client bphdb NetBackup Master Server Scheduler NetBackup For a backup, brbackup calls the NetBackup for SAP backint interface. The backint interface calls the XBSA API to interface with NetBackup. A restore works similarly except that the NetBackup for SAP backint interface calls the XBSA API, causing NetBackup to retrieve the data from secondary storage and send it to the client. NetBackup for SAP on Oracle Databases The following sections provide an overview of the software in a NetBackup for SAP on Oracle database environment. You can use NetBackup for SAP on Oracle databases either with or without the recovery manager (RMAN). The following subsections explain the components in Oracle environments with and without RMAN. 6 NetBackup for SAP System Administrator s Guide for UNIX and Linux

NetBackup for SAP Overview Using NetBackup for SAP on Oracle Databases Without RMAN The following figure shows the components found in a NetBackup for SAP on Oracle database environment: Software Components in a NetBackup for SAP on Oracle Database Environment Oracle Database SAP Environment sapdba SAP Tools brbackup brrestore brarchive brconnect NetBackup for SAP backint Interface NetBackup XBSA API Using NetBackup for SAP on Oracle Databases With RMAN NetBackup for SAP implements the Oracle Defined SBT interface, which integrates the SAP tools with RMAN. You do not need to use RMAN to use NetBackup for SAP on Oracle databases, but the benefits of using RMAN backups are as follows: RMAN supports incremental backups, which are backups of only those blocks that have changed since the previous backup. This reduces the number of blocks that are backed up. Unused and unchanged database blocks are not backed up. RMAN detects logical errors in database blocks during backup processing. The BEGIN BACKUP and END BACKUP commands are not needed for online backups because RMAN performs a block-by-block check to verify data consistency. This reduces the amount of redo log information. You can use RMAN s verify command to verify backups. The following diagram shows a NetBackup for SAP on Oracle database environment that includes RMAN: Chapter 1, Introduction 7

NetBackup for SAP Overview Software Components in a NetBackup for SAP on Oracle Database Environment with RMAN SAP Tools Oracle Database Phase 2 Phase 1 RMAN Oracle Server libobk (liborasap) (NetBackup for Oracle) Control Files Profiles Log Files backint NetBackup for SAP NetBackup Media Manager or Disk Storage Unit Local Disk If you are in a NetBackup for SAP on Oracle database environment with RMAN, the backup consists of two phases: Phase 1 backs up the Oracle database files. Phase 2 backs up the SAP control, log, and configuration files. 8 NetBackup for SAP System Administrator s Guide for UNIX and Linux

NetBackup for SAP Overview SAP Tools Overview The SAP Environment consists of many modules and applications. One component is the SAP tools. You can use the SAP tools whether or not you also use RMAN. The following table shows the software included in the SAP tools. SAP Tools Software Component sapdba brbackup brarchive brrestore SAP script Function sapdba is a menu-driven utility, with menus designed to reflect the user s point of view. sapdba provides easy access to brbackup, brarchive, and brrestore for database backups and restores. The tool can restore a backup of an entire database or reset the database to a previous state. This command brings database servers online or offline, checks the status of SAP files, and places database tablespaces into BACKUP mode to guarantee their data consistency. The brbackup command provides online and offline backups. It also keeps a profile and log of each backup. brbackup uses the NetBackup software, through NetBackup for SAP, for the following actions: SAP datafile backups Datafile and online log backups Error handling This command archives Oracle offline redo log files by communicating with the NetBackup for SAP backint interface. These files are copied by Oracle in its archiving directory. The brarchive command ensures that duplicates of these logs are available and that original files are not deleted prematurely. This command also keeps a profile and log of each archive. This command recovers database data files, control files, and online redo log files through the NetBackup for SAP backint interface. The brrestore command ensures that sufficient space is available prior to restoring these files, and it removes files that will be overwritten during the recovery. This command also provides a query mode. This is a small script that contains SAP commands such as brbackup and brrestore. Chapter 1, Introduction 9

NetBackup for SAP Overview NetBackup for SAP on MaxDB Databases The following figure shows the components found in a NetBackup for SAP on MaxDB database environment. Software Components for a NetBackup for SAP on MaxDB Database Environment DBM CLI DBM GUI Web DBM MaxDB Server MaxDB Instance Named Pipes NetBackup for SAP (backint) NetBackup 10 NetBackup for SAP System Administrator s Guide for UNIX and Linux

Installation 2 This chapter describes how to perform the following tasks: Verifying the installation prerequisites for NetBackup for SAP. Perform this task before installing this agent. Installing NetBackup for SAP. Enabling functions specific to NetBackup for SAP. Verifying the Installation Prerequisites Before installing NetBackup for SAP, verify that you are installing the agent on a supported operating system or platform and that requirements are met for the NetBackup software, the database agent, and, if applicable, the cluster software. These requirements apply for remote and local installations. Operating System and Platform Compatibility Verify that NetBackup for SAP will be installed on an operating system or platform supported by NetBackup. A compatibility list for database agents is available on the Technical Support web site. To verify compatibility 1. Go to the Technical Support web page: http://support.veritas.com. 2. From the Select Product Family list, click NetBackup Products. 3. From the Select Product list in the right pane, click NetBackup Enterprise Server. 4. Under Support Resources, click Compatibility and Reference. 11

Verifying the Installation Prerequisites 5. In the list of documents, click NetBackup Enterprise Server (tm)/ Server x.x Database Agent Compatibility (updated date). For x.x, look for the current release. For date, look for the most recent date. For information on supported cluster environments for NetBackup for SAP, see NetBackup (tm) x.x Cluster Compatibility (updated date). 6. Click on the link for the PDF document, which is a downloadable file that enables you to view the supported database spreadsheet for this release. 7. Read the document and verify that the software in your environment is compatible with the NetBackup and NetBackup for SAP software. NetBackup Software Verify that the following requirements are met for the NetBackup server and client software: The NetBackup server software is installed and operational on the NetBackup server. The NetBackup server platform can be any of those that NetBackup supports. For installation information, see the NetBackup Installation Guide. The NetBackup client software is installed on the client where you will be backing up the databases. The version of the NetBackup client and the version of NetBackup for SAP to be installed must be the same (for example, 6.0). There must be adequate disk space on each machine upon which you are installing NetBackup for SAP. Less than two megabytes of additional disk space is required in the /usr/openv/netbackup directory. However, more disk space might be needed at run time. Make sure that you have configured backup media in a Media Manager or disk storage unit. The amount of backup media required depends on the devices used, the sizes of the databases that you are backing up, the amount of data that you are archiving, the size of your backups, and the frequency of backups or archives. For information on using Media Manager, see the NetBackup Media Manager System Administrator s Guide. Database Software Verify the following regarding the database software on the NetBackup client: 12 NetBackup for SAP System Administrator s Guide for UNIX and Linux

Verifying the Installation Prerequisites SAP vendor software must be installed and operational. One or more SAP instances must exist. For information on installing SAP and creating instances, see your SAP documentation. Cluster Software Verify the following requirements if you are installing the NetBackup for SAP software on a NetBackup server configured in a NetBackup cluster: The SAP vendor software is installed and operational on each node to which NetBackup can failover. The NetBackup server software is installed and configured to work in a NetBackup cluster. Follow the instructions in the NetBackup Installation Guide, including running the cluster_config script after the NetBackup server software has been installed. You only need to run the cluster_config script after you install the NetBackup server software. You do not need to run cluster_config after installing NetBackup for SAP on a NetBackup server that is part of a NetBackup cluster. The following additional information also pertains to cluster environments: Make sure you install the NetBackup client software and the NetBackup for SAP software on each node to which NetBackup can failover. Run commands such as bpplclients and update_dbclients from the active NetBackup master or media server. If you plan to perform a remote installation, in which you push the database agent software to clients located in a cluster, specify the individual node names, not the virtual names, in the client list. Chapter 2, Installation 13

Installing NetBackup for SAP Installing NetBackup for SAP You can install the database agent software in one of the following ways: A remote installation. The user loads the software onto a master server or a media server and then pushes the database software out to the clients. You can perform an initial or upgrade remote installation in this manner. Remote Installation of NetBackup for SAP on page 14 describes this procedure. A local installation. The user loads and installs the software onto the local machine only. Local Installation of NetBackup for SAP on page 22 describes this procedure. Remote Installation of NetBackup for SAP During a remote installation, you load the NetBackup for SAP files onto either a UNIX master server or media server, and then you push the software to the clients to install it. Loading the NetBackup for SAP Files onto the Server To load the NetBackup for SAP files on a UNIX server 1. Review Verifying the Installation Prerequisites on page 11. If you are installing NetBackup for SAP on a clustered NetBackup server, be sure to read Cluster Software on page 13. 2. (Conditional) Perform this step only if you are installing on a server that is part of a NetBackup cluster. a. Freeze the active NetBackup node. When you install NetBackup for SAP, install the software on all the inactive nodes first, then install on the active node. For information on how to freeze the active node in your specific cluster environment, see the NetBackup High Availability System Administrator s Guide. b. Decide which of the inactive nodes to install the software on first. In the next step, you log in to the first machine and commence the installation process. Because you need to perform the installation on all inactive nodes first, make sure that the first machine you select is an inactive node. 3. Log in as the root user on the master or media server. If you are already logged in, but are not the root user, run the following command: 14 NetBackup for SAP System Administrator s Guide for UNIX and Linux

Installing NetBackup for SAP su - root 4. Verify that a registered and valid license key for NetBackup for SAP resides on the master server. You can obtain master server license information from either the master server or the media server. To view or add license keys, perform one of the following actions: From the master or media server, run the following command: /usr/openv/netbackup/bin/admincmd/get_license_key When the system prompts you, type the host name of the NetBackup master server. Open the NetBackup Administration Console and choose Help > License Keys. If the NetBackup master server is part of a NetBackup cluster, the license key must be registered on each node. 5. Mount the CD-ROM. For more information on how to mount a CD-ROM, see the NetBackup Installation Guide. 6. Change the working directory to the CD-ROM directory. For example: cd /CD_mount_point 7. Invoke the install script to load and install the software. For example:./install a. Select the NetBackup Database Agent Software option. The following prompt appears: Do you want to do a local installation? (y/n) [n] b. Answer n. A menu of all database agents available on the CD-ROM displays. c. Select the NetBackup for SAP option. d. Type q to quit selecting options. A prompt appears asking if the list is correct. Chapter 2, Installation 15

Installing NetBackup for SAP e. Answer y. The install script identifies the types of client software loaded during the installation of the NetBackup server. By default, any matching NetBackup for SAP software is automatically loaded. If there are more platforms available, the script displays a menu that gives you the opportunity to add more client types to the default list. After the list is complete, the installation script copies database agent version files, tar(1) files compressed with gzip(1), and the install_dbext script to directory /usr/openv/netbackup/dbext. 8. (Conditional) Select another node upon which to install the software. Perform this step under the following circumstances: If you are installing the NetBackup for SAP software on a server that is part of a NetBackup cluster. and If you have nodes that still need to have the software installed. If there are inactive nodes that do not yet have the software installed upon them, select one of these inactive nodes, and repeat step 3 through step 8 for that node. If you have installed the software on all the inactive nodes, select the active node and repeat step 3 through step 8 for that node. If you have installed on all the nodes, proceed to step 9. 9. (Conditional) Unfreeze the active node. Perform this step if you are installing the NetBackup for SAP software on a server that is part of a NetBackup cluster. Unfreezing the active node is the last step in the installation process. Unfreeze the active node only after all the software has been installed on all nodes. For information on how to unfreeze the active node in your specific cluster environment, see the NetBackup High Availability System Administrator s Guide. 10. Decide how you want to distribute the NetBackup for SAP software to the clients. Regardless of whether you are upgrading clients in an existing environment or you are performing a new installation, use one of the following methods: Distribute to all clients currently specified in a SAP policy type. This method distributes the NetBackup for SAP software to all clients that are currently included in a SAP policy type. You can use this method only if you are pushing from a master server. For information on this method, see Pushing the Software to All Clients Currently Specified in an SAP Policy Type on page 17. 16 NetBackup for SAP System Administrator s Guide for UNIX and Linux

Installing NetBackup for SAP Distribute to selected clients. This method distributes the NetBackup for SAP software to selected clients only. If you are performing a new installation, and you plan to add clients to a SAP policy type after you install the software, you can install the software on such clients now and configure the policy later. This method also allows you to skip clients that you do not want to upgrade to 6.0 at this time. You can use this method whether you are pushing from a master server or from a media server. For information on this method, see Pushing the Software to New or Selected Clients on page 20. Note Make sure that the NetBackup for SAP version is the same version as the NetBackup client software. Pushing the Software to All Clients Currently Specified in an SAP Policy Type Use the following procedure if you want to install or upgrade the NetBackup for SAP software on all clients currently configured in an SAP policy type. You can use this procedure only from a master server. To push the software to all clients specified in an SAP policy type Note If you are pushing the NetBackup for SAP software from a server that is part of a NetBackup cluster, type all commands in this procedure from the active NetBackup node. 1. Run the update_dbclients command to launch the installation script. Type the following command: /usr/openv/netbackup/bin/update_dbclients SAP ALL ALL 2. Examine the client list that the update_dbclients command returns. a. Locate the client list. The update_dbclients command compiles a list of clients that it detects are included in a SAP policy type. It presents this list to you. If 9 or fewer clients are in the client list, update_dbclients displays all the client names. If 10 or more clients are on the client list, update_dbclients writes the first 9 to standard output and writes the entire list to $TMPDIR/NB_DBCLIENT_LIST.identifier, where identifier is a mix of date, time, and process identifier information. If the TMPDIR environment variable is not set, the default is /tmp. b. Check the client list. Chapter 2, Installation 17

Installing NetBackup for SAP The host names of the clients must be the clients individual node names. They cannot be virtual names. The correct value for the individual node names is returned by the hostname(1) and the domainname(1) commands. The format can be either hostname or hostname.domainname. If the client list contains virtual names, you cannot complete this procedure. Do one of the following: To exit this procedure if there are two or more clients, press the Enter key and then type n to stop the upgrade and exit from this installation dialog. To install the software in this situation, use Pushing the Software to New or Selected Clients on page 20. To exit this procedure if there is only one client, type n. To install the software in this situation, use Pushing the Software to New or Selected Clients on page 20. If the client list contains only individual node names, proceed to the following step. c. Check the skipped client list, if any. If update_dbclients detects that it cannot update a particular client, it does not include the name of that client in the client list. Such clients are skipped for one or more of the following reasons: The client is a PC client. You cannot install or upgrade NetBackup for SAP on a PC client from a UNIX server. The database agent does not support the client's platform type. The database agent software for that client type was not loaded onto the server in To load the NetBackup for SAP files on a UNIX server on page 14. The client does not belong to an SAP policy type. The skipped client list is in $TMPDIR/skipped_clients.PID, where PID is the process identifier. If the TMPDIR environment variable is not set, the default is /tmp. If no file is present, no clients were skipped. 3. (Conditional) Specify the number of simultaneous client updates. If you are updating more than one client, the installation software displays the number of updates required to distribute the software to the clients. If the software detects the need to update more than one client, it displays the following prompt: 18 NetBackup for SAP System Administrator s Guide for UNIX and Linux

Installing NetBackup for SAP Enter the number of simultaneous updates you wish to take place. [1 - max] (default: dflt) max dflt The maximum number of simultaneous updates that is allowed. The value displayed ranges from 1 to 30. The number the program uses if you press Enter without specifying a number. The value displayed ranges from 1 to 15. If you want the installation software to perform dflt simultaneous updates, press Enter. If you want to specify a different number of simultaneous updates, type a number in the range 1 number max, and then press Enter. For example, if three clients are to be updated, the max and dflt values are 3. If 50 clients are to be updated, the max value is 30, and the dflt value is 15. update_dbclients starts the number of updates that you specify. If this number is less than the total number of client updates to be performed, new updates start as the previous updates finish until all of the updates have been completed. 4. Indicate whether or not you want to upgrade the clients at this time. Based on your answer, the time it will take to update the clients is displayed, followed by this question: Do you want to upgrade the clients now? (y/n) [y] Type y or n for the prompt. If you answer n, update_dbclients quits and leaves the list of clients it would have updated in a file. You can use this file later as the argument to the -ClientList parameter. By default, the installation software writes the client list to $TMPDIR/NB_DBCLIENT_LIST.identifier, where identifier is a mix of date, time, and process identifier information. If the TMPDIR environment variable is not set, the default is /tmp. If you answer y, you continue the installation process. The following actions occur: The update_dbclients command distributes the software to the client. If it is successful, update_dbclients invokes the install_dbext script on the client. The install_dbext script runs on each client. If it is successful, it writes a version file in directory /usr/openv/share that contains the version of NetBackup for SAP that was installed. Chapter 2, Installation 19

Installing NetBackup for SAP The update_dbclients command displays a note on whether the update was successful for each client. When the update_dbclients command completes, it displays a file name that contains a complete log of what happened for each client. If the update failed for any client, examine the log file to determine the problem. Pushing the Software to New or Selected Clients Use the following procedure if you want to install or upgrade the NetBackup for SAP software on selected clients. You can use this procedure from either a master server or from a media server. To push the software to new or selected clients Note If you are pushing the NetBackup for SAP software from a server that is part of a NetBackup cluster, type all commands in this procedure from the active NetBackup node. 1. On the master server, type the following command to ensure that the bpdbm daemon is running: /usr/openv/netbackup/bin/bpps If the output shows that the bpdbm daemon is not running, type the following command to start the daemon: /usr/openv/netbackup/bin/initbpdbm 2. Type the following command to change to the NetBackup bin directory: cd /usr/openv/netbackup/bin 3. Use the bpplclients(1m) command to create a file that contains a list of clients currently configured in the NetBackup database. The options to use on this command differ depending on whether you are installing from a master server or from a media server, as follows: If you are performing the install from the master server, type the following command:./admincmd/bpplclients -allunique -noheader > file If you are performing the install from a media server, type the following command: 20 NetBackup for SAP System Administrator s Guide for UNIX and Linux

Installing NetBackup for SAP./admincmd/bpplclients -allunique -noheader -M ms_name > file ms_name file Name of the NetBackup master server in this environment. Name of the file to contain the list of unique clients. If no clients have been configured in the NetBackup database, file is empty. Create file using the same format as that generated by bpplclients. bpplclients writes output to file in the following format: hardware op_system client hardware The hardware name. For examples, execute the ls(1) command in directory /usr/openv/netbackup/client. op_system The operating system name. For examples, execute the ls(1) command in directory /usr/openv/netbackup/client/hardware. client The name of the client. For example, file might contain a line like the following: Solaris Solaris8 curry 4. (Optional) Edit file. Perform this step to change the contents of file. Edit file to contain only those clients you want to update with NetBackup for SAP software. The host names of the clients must be the clients individual node names. They cannot be virtual names. The correct value for the individual node names is returned by the hostname(1) and the domainname(1) commands. The format can be either hostname or hostname.domainname. 5. Run the update_dbclients command to install the software. Specify the file you created in step 3 as the argument to update_dbclients. The command installs the software on the clients listed in file. For example:./update_dbclients SAP -ClientList file 6. Answer questions as prompted by the update_dbclients command. Chapter 2, Installation 21

Installing NetBackup for SAP The update_dbclients command initiates a dialog with you. It asks you to confirm actions during the update process and presents options to you if there are choices to be made. For information about this dialog, see the instructions starting with step 2 on page 17. Note You do not need to run the cluster_config script after installing NetBackup for SAP on a server that is part of a NetBackup cluster. Local Installation of NetBackup for SAP During a local installation, the NetBackup for SAP files are extracted and installed. The local machine can be a client or a server that also happens to be a NetBackup for SAP client. To install NetBackup for SAP on a local machine 1. Review Verifying the Installation Prerequisites on page 11. If you are installing NetBackup for SAP on a clustered NetBackup server, also see Cluster Software on page 13. 2. (Conditional) Perform this step only if you are installing on a server that is part of a NetBackup cluster. a. Freeze the active NetBackup node. When you install NetBackup for SAP, install the software on all the inactive nodes first, then install on the active node. For information on how to freeze the active node in your specific cluster environment, see the NetBackup High Availability System Administrator s Guide. b. Decide which of the inactive nodes to install the software on first. In the next step, you log in to the first machine and commence the installation process. Because you need to perform the installation on all inactive nodes first, make sure that the first machine you select is an inactive node. 3. Log in as the root user on the machine. If you are already logged in, but are not the root user, run the following command. su - root 4. (Conditional) Log into a media server or the master server. Perform this step if the local machine is a NetBackup client. 22 NetBackup for SAP System Administrator s Guide for UNIX and Linux