+ All Categories
Home > Documents > VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install,...

VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install,...

Date post: 14-Feb-2018
Category:
Upload: dinhtu
View: 224 times
Download: 1 times
Share this document with a friend
78
VERITAS NetBackup 6.0 for Sybase System Administrator’s Guide for UNIX N15263B September 2005
Transcript
Page 1: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

N15263B

September 2005

VERITAS NetBackuptrade 60

for Sybase

System Administratorrsquos Guide

for UNIX

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 copy 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 US 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 wwwveritascom

Third-Party Copyrights

For a list of third-party copyrights see the NetBackup Release Notes appendix

ii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Contents

Preface vii

Getting Help vii

Finding NetBackup Documentation vii

Accessing the VERITAS Technical Support Web Site viii

Contacting VERITAS Licensing ix

Accessibility Features ix

Comment on the Documentation x

Chapter 1 Introduction 1

NetBackup for Sybase Features 2

NetBackup for Sybase Terminology 4

NetBackup for Sybase Overview 5

SQL Server and Sybase Backup Server 5

NetBackup for Sybase 6

Sequence of Operation 7

Chapter 2 Installation 9

Verifying the Installation Prerequisites 9

Operating System and Platform Compatibility 9

NetBackup Software 10

Database Software 10

Cluster Software 11

Installing NetBackup for Sybase 12

Remote Installation of NetBackup for Sybase 12

iii

Loading the NetBackup for Sybase Files onto the Server 12

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type 15

Pushing the Software to New or Selected Clients 18

Local Installation of NetBackup for Sybase 20

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only) 24

Specifying the Sybase Home Path 25

Adding New Sybase Instances 25

Chapter 3 Configuration 27

User Interface Terminology Notes 27

Configuring the Maximum Jobs Per Client 28

Configuring Backup Policies 29

Planning NetBackup for Sybase Policies and Schedules 29

Adding a New Policy 30

Description of Attributes 31

Adding Schedules 31

Types of Backup Schedules 34

Schedule Properties 34

Adding Clients 36

Adding Backup Selections 37

Modifying the Backup Restore and Load Scripts 39

Modifying the Backup Script 40

Modifying the Restore Script 43

Modifying the Load Script 45

Environment Variables 46

Configuring the bpconf File 47

Creating a $SYBASE_HOMEbpconf File on the Client 47

Specifying Options in usropenvnetbackupbpconf on the Client 48

Enabling Striped Dumps and Loads 49

Example Scripts for Striped Dumps and Loads 49

iv NetBackup for Sybase System Administratorrsquos Guide for UNIX

Multiplexing Considerations - Duplicating Tapes 49

Multiplexing Considerations - Using more than 12 Stripes 50

Testing Configuration Settings 51

Chapter 4 Using NetBackup for Sybase 53

Performing a Backup 54

Backup Strategy 54

Automatic Backup of a Sybase Database 54

Manual Backup of a Sybase Database 55

User-Directed Backup 55

Browsing Backups 56

Performing a Restore 57

Using isql to Restore a Sybase Database 57

Redirected Restore Configuration on the Client 58

Chapter 5 Troubleshooting 59

NetBackup and NetBackup for Sybase Logs 60

Enabling Logging 60

Accessing the Log Files 61

bphdb Directory on the Client 61

sybackup Directory on the Client 61

NetBackup Server Reports 62

Setting the Debug Level 62

Sybase Backup Server Log and Messages 62

DUMP and LOAD Progress Messages 62

Error Logging 63

Minimizing Timeout Failures on Large Database Restores 63

Index 65

Contents v

vi NetBackup for Sybase System Administratorrsquos Guide for UNIX

Preface

This guide describes how to install configure and use NetBackup for Sybase on a UNIX platform For information about the NetBackup server software see the following platform-specific manuals

NetBackup System Administratorrsquos Guide for UNIX Volumes I and II

NetBackup System Administratorrsquos 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 gt Help Topics

2 Click the Contents tab

3 Click Glossary of NetBackup Terms

Use the scroll function to navigate through the glossary

vii

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 2: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

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 copy 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 US 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 wwwveritascom

Third-Party Copyrights

For a list of third-party copyrights see the NetBackup Release Notes appendix

ii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Contents

Preface vii

Getting Help vii

Finding NetBackup Documentation vii

Accessing the VERITAS Technical Support Web Site viii

Contacting VERITAS Licensing ix

Accessibility Features ix

Comment on the Documentation x

Chapter 1 Introduction 1

NetBackup for Sybase Features 2

NetBackup for Sybase Terminology 4

NetBackup for Sybase Overview 5

SQL Server and Sybase Backup Server 5

NetBackup for Sybase 6

Sequence of Operation 7

Chapter 2 Installation 9

Verifying the Installation Prerequisites 9

Operating System and Platform Compatibility 9

NetBackup Software 10

Database Software 10

Cluster Software 11

Installing NetBackup for Sybase 12

Remote Installation of NetBackup for Sybase 12

iii

Loading the NetBackup for Sybase Files onto the Server 12

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type 15

Pushing the Software to New or Selected Clients 18

Local Installation of NetBackup for Sybase 20

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only) 24

Specifying the Sybase Home Path 25

Adding New Sybase Instances 25

Chapter 3 Configuration 27

User Interface Terminology Notes 27

Configuring the Maximum Jobs Per Client 28

Configuring Backup Policies 29

Planning NetBackup for Sybase Policies and Schedules 29

Adding a New Policy 30

Description of Attributes 31

Adding Schedules 31

Types of Backup Schedules 34

Schedule Properties 34

Adding Clients 36

Adding Backup Selections 37

Modifying the Backup Restore and Load Scripts 39

Modifying the Backup Script 40

Modifying the Restore Script 43

Modifying the Load Script 45

Environment Variables 46

Configuring the bpconf File 47

Creating a $SYBASE_HOMEbpconf File on the Client 47

Specifying Options in usropenvnetbackupbpconf on the Client 48

Enabling Striped Dumps and Loads 49

Example Scripts for Striped Dumps and Loads 49

iv NetBackup for Sybase System Administratorrsquos Guide for UNIX

Multiplexing Considerations - Duplicating Tapes 49

Multiplexing Considerations - Using more than 12 Stripes 50

Testing Configuration Settings 51

Chapter 4 Using NetBackup for Sybase 53

Performing a Backup 54

Backup Strategy 54

Automatic Backup of a Sybase Database 54

Manual Backup of a Sybase Database 55

User-Directed Backup 55

Browsing Backups 56

Performing a Restore 57

Using isql to Restore a Sybase Database 57

Redirected Restore Configuration on the Client 58

Chapter 5 Troubleshooting 59

NetBackup and NetBackup for Sybase Logs 60

Enabling Logging 60

Accessing the Log Files 61

bphdb Directory on the Client 61

sybackup Directory on the Client 61

NetBackup Server Reports 62

Setting the Debug Level 62

Sybase Backup Server Log and Messages 62

DUMP and LOAD Progress Messages 62

Error Logging 63

Minimizing Timeout Failures on Large Database Restores 63

Index 65

Contents v

vi NetBackup for Sybase System Administratorrsquos Guide for UNIX

Preface

This guide describes how to install configure and use NetBackup for Sybase on a UNIX platform For information about the NetBackup server software see the following platform-specific manuals

NetBackup System Administratorrsquos Guide for UNIX Volumes I and II

NetBackup System Administratorrsquos 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 gt Help Topics

2 Click the Contents tab

3 Click Glossary of NetBackup Terms

Use the scroll function to navigate through the glossary

vii

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 3: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Contents

Preface vii

Getting Help vii

Finding NetBackup Documentation vii

Accessing the VERITAS Technical Support Web Site viii

Contacting VERITAS Licensing ix

Accessibility Features ix

Comment on the Documentation x

Chapter 1 Introduction 1

NetBackup for Sybase Features 2

NetBackup for Sybase Terminology 4

NetBackup for Sybase Overview 5

SQL Server and Sybase Backup Server 5

NetBackup for Sybase 6

Sequence of Operation 7

Chapter 2 Installation 9

Verifying the Installation Prerequisites 9

Operating System and Platform Compatibility 9

NetBackup Software 10

Database Software 10

Cluster Software 11

Installing NetBackup for Sybase 12

Remote Installation of NetBackup for Sybase 12

iii

Loading the NetBackup for Sybase Files onto the Server 12

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type 15

Pushing the Software to New or Selected Clients 18

Local Installation of NetBackup for Sybase 20

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only) 24

Specifying the Sybase Home Path 25

Adding New Sybase Instances 25

Chapter 3 Configuration 27

User Interface Terminology Notes 27

Configuring the Maximum Jobs Per Client 28

Configuring Backup Policies 29

Planning NetBackup for Sybase Policies and Schedules 29

Adding a New Policy 30

Description of Attributes 31

Adding Schedules 31

Types of Backup Schedules 34

Schedule Properties 34

Adding Clients 36

Adding Backup Selections 37

Modifying the Backup Restore and Load Scripts 39

Modifying the Backup Script 40

Modifying the Restore Script 43

Modifying the Load Script 45

Environment Variables 46

Configuring the bpconf File 47

Creating a $SYBASE_HOMEbpconf File on the Client 47

Specifying Options in usropenvnetbackupbpconf on the Client 48

Enabling Striped Dumps and Loads 49

Example Scripts for Striped Dumps and Loads 49

iv NetBackup for Sybase System Administratorrsquos Guide for UNIX

Multiplexing Considerations - Duplicating Tapes 49

Multiplexing Considerations - Using more than 12 Stripes 50

Testing Configuration Settings 51

Chapter 4 Using NetBackup for Sybase 53

Performing a Backup 54

Backup Strategy 54

Automatic Backup of a Sybase Database 54

Manual Backup of a Sybase Database 55

User-Directed Backup 55

Browsing Backups 56

Performing a Restore 57

Using isql to Restore a Sybase Database 57

Redirected Restore Configuration on the Client 58

Chapter 5 Troubleshooting 59

NetBackup and NetBackup for Sybase Logs 60

Enabling Logging 60

Accessing the Log Files 61

bphdb Directory on the Client 61

sybackup Directory on the Client 61

NetBackup Server Reports 62

Setting the Debug Level 62

Sybase Backup Server Log and Messages 62

DUMP and LOAD Progress Messages 62

Error Logging 63

Minimizing Timeout Failures on Large Database Restores 63

Index 65

Contents v

vi NetBackup for Sybase System Administratorrsquos Guide for UNIX

Preface

This guide describes how to install configure and use NetBackup for Sybase on a UNIX platform For information about the NetBackup server software see the following platform-specific manuals

NetBackup System Administratorrsquos Guide for UNIX Volumes I and II

NetBackup System Administratorrsquos 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 gt Help Topics

2 Click the Contents tab

3 Click Glossary of NetBackup Terms

Use the scroll function to navigate through the glossary

vii

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 4: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Loading the NetBackup for Sybase Files onto the Server 12

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type 15

Pushing the Software to New or Selected Clients 18

Local Installation of NetBackup for Sybase 20

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only) 24

Specifying the Sybase Home Path 25

Adding New Sybase Instances 25

Chapter 3 Configuration 27

User Interface Terminology Notes 27

Configuring the Maximum Jobs Per Client 28

Configuring Backup Policies 29

Planning NetBackup for Sybase Policies and Schedules 29

Adding a New Policy 30

Description of Attributes 31

Adding Schedules 31

Types of Backup Schedules 34

Schedule Properties 34

Adding Clients 36

Adding Backup Selections 37

Modifying the Backup Restore and Load Scripts 39

Modifying the Backup Script 40

Modifying the Restore Script 43

Modifying the Load Script 45

Environment Variables 46

Configuring the bpconf File 47

Creating a $SYBASE_HOMEbpconf File on the Client 47

Specifying Options in usropenvnetbackupbpconf on the Client 48

Enabling Striped Dumps and Loads 49

Example Scripts for Striped Dumps and Loads 49

iv NetBackup for Sybase System Administratorrsquos Guide for UNIX

Multiplexing Considerations - Duplicating Tapes 49

Multiplexing Considerations - Using more than 12 Stripes 50

Testing Configuration Settings 51

Chapter 4 Using NetBackup for Sybase 53

Performing a Backup 54

Backup Strategy 54

Automatic Backup of a Sybase Database 54

Manual Backup of a Sybase Database 55

User-Directed Backup 55

Browsing Backups 56

Performing a Restore 57

Using isql to Restore a Sybase Database 57

Redirected Restore Configuration on the Client 58

Chapter 5 Troubleshooting 59

NetBackup and NetBackup for Sybase Logs 60

Enabling Logging 60

Accessing the Log Files 61

bphdb Directory on the Client 61

sybackup Directory on the Client 61

NetBackup Server Reports 62

Setting the Debug Level 62

Sybase Backup Server Log and Messages 62

DUMP and LOAD Progress Messages 62

Error Logging 63

Minimizing Timeout Failures on Large Database Restores 63

Index 65

Contents v

vi NetBackup for Sybase System Administratorrsquos Guide for UNIX

Preface

This guide describes how to install configure and use NetBackup for Sybase on a UNIX platform For information about the NetBackup server software see the following platform-specific manuals

NetBackup System Administratorrsquos Guide for UNIX Volumes I and II

NetBackup System Administratorrsquos 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 gt Help Topics

2 Click the Contents tab

3 Click Glossary of NetBackup Terms

Use the scroll function to navigate through the glossary

vii

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 5: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Multiplexing Considerations - Duplicating Tapes 49

Multiplexing Considerations - Using more than 12 Stripes 50

Testing Configuration Settings 51

Chapter 4 Using NetBackup for Sybase 53

Performing a Backup 54

Backup Strategy 54

Automatic Backup of a Sybase Database 54

Manual Backup of a Sybase Database 55

User-Directed Backup 55

Browsing Backups 56

Performing a Restore 57

Using isql to Restore a Sybase Database 57

Redirected Restore Configuration on the Client 58

Chapter 5 Troubleshooting 59

NetBackup and NetBackup for Sybase Logs 60

Enabling Logging 60

Accessing the Log Files 61

bphdb Directory on the Client 61

sybackup Directory on the Client 61

NetBackup Server Reports 62

Setting the Debug Level 62

Sybase Backup Server Log and Messages 62

DUMP and LOAD Progress Messages 62

Error Logging 63

Minimizing Timeout Failures on Large Database Restores 63

Index 65

Contents v

vi NetBackup for Sybase System Administratorrsquos Guide for UNIX

Preface

This guide describes how to install configure and use NetBackup for Sybase on a UNIX platform For information about the NetBackup server software see the following platform-specific manuals

NetBackup System Administratorrsquos Guide for UNIX Volumes I and II

NetBackup System Administratorrsquos 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 gt Help Topics

2 Click the Contents tab

3 Click Glossary of NetBackup Terms

Use the scroll function to navigate through the glossary

vii

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 6: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

vi NetBackup for Sybase System Administratorrsquos Guide for UNIX

Preface

This guide describes how to install configure and use NetBackup for Sybase on a UNIX platform For information about the NetBackup server software see the following platform-specific manuals

NetBackup System Administratorrsquos Guide for UNIX Volumes I and II

NetBackup System Administratorrsquos 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 gt Help Topics

2 Click the Contents tab

3 Click Glossary of NetBackup Terms

Use the scroll function to navigate through the glossary

vii

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 7: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Preface

This guide describes how to install configure and use NetBackup for Sybase on a UNIX platform For information about the NetBackup server software see the following platform-specific manuals

NetBackup System Administratorrsquos Guide for UNIX Volumes I and II

NetBackup System Administratorrsquos 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 gt Help Topics

2 Click the Contents tab

3 Click Glossary of NetBackup Terms

Use the scroll function to navigate through the glossary

vii

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 8: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Getting Help

Accessing the VERITAS Technical Support Web Site

The address for the VERITAS Technical Support Web site is httpsupportveritascom

The VERITAS Support Web site lets you do any of the following

Obtain updated information about NetBackup for Sybase including systemrequirements 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 Sybase 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 Sybase training

Read current white papers related to NetBackup for Sybase

From httpsupportveritascom you can complete various tasks to obtain specific types of support for NetBackup for Sybase

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 httpsupportveritascom 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 httpsupportveritascom by clicking the Phone Support icon A page appears that contains VERITAS support numbers from around the world

Note Telephone support for NetBackup for Sybase 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

viii NetBackup for Sybase System Administratorrsquos Guide for UNIX

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 9: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Accessibility Features

a From the main httpsupportveritascom 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 amercustomercareveritascom

In the Asia and Pacific areas send email to apaccustomercareveritascom

In all other areas send email to internationallicenseveritascom

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 ix

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 10: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

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 NBDocsveritascom

Please only use this address to comment on product documentation See ldquoGetting Helprdquo in this preface for information on how to contact Technical Support about our software

We appreciate your feedback

x NetBackup for Sybase System Administratorrsquos Guide for UNIX

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 11: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Introduction

1

NetBackup for Sybase integrates the database backup and recovery capabilities of Sybase Backup Server with the backup and recovery management capabilities of NetBackup and Media Manager

This chapter introduces NetBackup for Sybase and explains how it relates to both Sybase Backup Server and NetBackup It contains the following sections

NetBackup for Sybase features

NetBackup for Sybase terminology

NetBackup for Sybase overview

1

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 12: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup for Sybase Features

NetBackup for Sybase Features

The following list shows NetBackup for Sybasersquos main features and introduces some terms used in the NetBackup for Sybase documentation For more information on general NetBackup terminology see the NetBackup System Administration Guide Volume I

Feature Description

Media and device All devices supported by Media Manager are available to NetBackup management for Sybase

Scheduling facilities NetBackup scheduling facilities on the master server can be used to schedule automatic and unattended Sybase backups

This also lets you choose the times when these operations can occurFor example to prevent interference with normal daytime operations you can schedule your database backups to occur only at night

Multiplexed backups and NetBackup for Sybase lets you take advantage of NetBackuprsquos restores multiplexing capabilities Multiplexing directs multiple data streams

to one backup device thereby reducing the time necessary to complete the operation

Transparent execution of All backups and restores run simultaneously and transparently both Sybase and regular file without any action from the NetBackup administrator system backup and restore The database administrator can run database backup and restore operations operations through NetBackup Alternatively you can use Sybase

Backup Server as if NetBackup were not present

An administrator or any other authorized user can use NetBackup torun database backups and restores

Sharing the same Media It is possible to share the same devices and media used for other Manager and disk storage backups or to give Sybase exclusive use of certain devices and media units used for other file backups

Centralized and networked From the NetBackup master server you can schedule database backup operations backups or start them manually for any client The Sybase databases

can also reside on hosts that are different from the devices on which NetBackup stores the backups

2 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 13: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup for Sybase Features

Feature Description

Graphical user interfaces 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 operations for Sybase from the NetBackup graphical user interface on the master server

Parallel backup and restore NetBackup for Sybase supports the parallel backup and restore operations capabilities of the Sybase Backup Server For example this permits

the user to run more than one tape device at a time for a single Sybase backup or restore thereby reducing the time necessary to complete the operation

Chapter 1 Introduction 3

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 14: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup for Sybase Terminology

NetBackup for Sybase Terminology

The following list shows terms that might be new to a Sybase database administrator or a NetBackup administrator

Term Meaning

SQL Server and Sybase Backup Server

SQL Server improves the backup and restore functions of Sybase Backup Server by using remote procedure calls (RPCs) to instruct Sybase Backup Server to back up or restore specific databases

NetBackup for Sybase enhances SQL Server functionality by integrating Sybase Backup Server with NetBackup This provides access to NetBackup media management and scheduling in addition to graphical and menu interfaces

SQL Server DUMP and These SQL Server commands are used for Sybase database backups and LOAD commands restores The DUMP command is used to back up The LOAD command is

used to restore

Archive device This dump device is used with the DUMP and LOAD commands It is required to support integration with NetBackup for Sybase

Sybase backup scripts Shell scripts that control NetBackup for Sybase operations

Sybase SQL script An SQL script that contains SQL commands to be performed by Sybase SQL Server

4 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 15: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup for Sybase Overview

NetBackup for Sybase Overview

The following example network shows the major components in a NetBackup for Sybase configuration The server that is hosting the Sybase database must be a NetBackup client and it must have NetBackup for Sybase installed

Example NetBackup for Sybase Configuration

System hosting the Sybase database

NetBackup master server

or remote media server

Sybase database software supplies

ndash SQL Server

ndash Backup Server

Network (TCPIP)

NetBackup for Sybase supplies

ndash Dynamically Loadable Library

ndash Sample script files

NetBackup software

ndash NetBackup Master Server

ndash NetBackup Media Server

Additional required NetBackup software

ndash NetBackup Client

Media Manager or

disk storage unit

Sybase database

(if system is a media server)

SQL Server and Sybase Backup Server

SQL Server performs Sybase backups and restores by sending Sybase DUMP and LOAD directives to Sybase Backup Server Sybase Backup Server is an Open Server application that prevents backup and restore tasks from interfering with user processes SQL Server and Sybase Backup Server are installed and configured with Sybasersquos regular installation facilities

Chapter 1 Introduction 5

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 16: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup for Sybase Overview

When either a Sybase DUMP or LOAD command is processed SQL Server sends Sybase Backup Server the directives to dump or load the specified database or transaction log These directives indicate which set of archive devices to use for the dump image Sybase Backup Server then handles all data transfer for the operation

For more information on SQL Server and Sybase Backup Server see your Sybase documentation

NetBackup for Sybase

NetBackup for Sybase has a dynamically loadable library that provides the functions necessary for Sybase Backup Server to use NetBackup This library is installed when NetBackup for Sybase is installed

NetBackup for Sybase is integrated with Sybase Backup Server through the Sybase Backup Server Archive API Sybase Backup Server uses the Archive API routines to issue IO requests to an archive-byte stream At run time Sybase Backup Server loads the NetBackup for Sybase library and makes calls to the API routines to open close read and write to the byte stream through this API interface

The dump-device string of the Sybase DUMP and LOAD commands is extended to support the Archive API The following syntax instructs Sybase Backup Server to use the NetBackup archive device to transfer data to and from NetBackup

sybackup

The Sybase DUMP command is as follows

dump database model to sybackup

SQL Server and Sybase Backup Server do not have a backup-catalog feature However when you perform a database or transaction dump NetBackup for Sybase automatically creates a file name for the dump image You must then specify this file name during a subsequent load operation

The file naming convention for the database and transaction dumps is the following

sql_server_namedatabase_namebackup_typestripe_numberpiddd-mm-yyyyhhmmss

The backup_type is either D for database or T for transaction

For example

SYBASE11mydbD02431217-12-2003140525

6 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 17: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup for Sybase Overview

Sequence of Operation

Sybase script files control the NetBackup operations A user selects a script through the NetBackup client user interface For more information see ldquoUsing NetBackup for Sybaserdquo on page 53

You use the NetBackup Administration Console to configure a schedule to use a script to perform NetBackup operations For more information see ldquoConfigurationrdquo on page 27

The following process takes place when a script is selected for a backup

1 A NetBackup process called bphdb starts the Sybase backup script on the client

2 The Sybase backup script starts the isql utility and uses the Sybase SQL script as an input file

3 SQL Server starts the requested operation on the databases

4 If the process requires media to store backup data NetBackup for Sybase starts a user-directed backup by using the NetBackup bpbackup command for Sybase database extension

5 The NetBackup media server connects to NetBackup for Sybase on the client

6 Sybase Backup Server sends data to NetBackup for Sybase which transfers data to the media server

7 The media server sends the data to a storage unit

A restore works in essentially the same manner except that NetBackup for Sybase issues a bprestore command This causes the media server to retrieve the data from the storage unit and send it to NetBackup for Sybase on the client

Sybase Backup Server supports parallel operations so it is possible to start more than one backup or restore operation

Note The Sybase Backup Server API does not support the Remote Sybase Backup Server feature NetBackup controls all network communications

Chapter 1 Introduction 7

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 18: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup for Sybase Overview

8 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 19: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installation

2

This chapter describes how to perform the following tasks

Verifying the installation prerequisites for NetBackup for Sybase Perform this task before installing this agent

Installing NetBackup for Sybase

Enabling functions specific to NetBackup for Sybase

Verifying the Installation Prerequisites

Before installing NetBackup for Sybase 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 Sybase 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 httpsupportveritascom

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

9

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 20: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Verifying the Installation Prerequisites

5 In the list of documents click NetBackup Enterprise Server (tm) Server xx Database Agent Compatibility (updated date)

For xx look for the current release For date look for the most recent date

For information on supported cluster environments for NetBackup for Sybase see NetBackup (tm) xx 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 Sybase 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 Sybase to be installed must be the same (for example 60)

There must be adequate disk space on each machine upon which you are installing NetBackup for Sybase Less than two megabytes of additional disk space is required in the usropenvnetbackup 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 Administratorrsquos Guide

Database Software

Verify the following regarding the database software on the NetBackup client

10 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 21: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Verifying the Installation Prerequisites

Sybase vendor software must be installed and operational

One or more Sybase instances must exist

For information on installing Sybase and creating instances see your Sybasedocumentation

Cluster Software

Verify the following requirements if you are installing the NetBackup for Sybase software on a NetBackup server configured in a NetBackup cluster

The Sybase 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 Sybase 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 Sybase 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 11

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 22: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

Installing NetBackup for Sybase

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 ldquoRemote Installation of NetBackup for Sybaserdquo on page 12 describes this procedure

A local installation The user loads and installs the software onto the local machine only ldquoLocal Installation of NetBackup for Sybaserdquo on page 20 describes this procedure

Remote Installation of NetBackup for Sybase

During a remote installation you load the NetBackup for Sybase 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 Sybase Files onto the Server

To load the NetBackup for Sybase files on a UNIX server

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server be sure to read ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

12 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 23: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

su - root

4 Verify that a registered and valid license key for NetBackup for Sybase 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

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt 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 (yn) [n]

b Answer n

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

Chapter 2 Installation 13

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 24: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

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 Sybase 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 usropenvnetbackupdbext

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 Sybase 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 Sybase 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 Administratorrsquos Guide

10 Decide how you want to distribute the NetBackup for Sybase 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 Sybase policy type This method distributes the NetBackup for Sybase software to all clients that are currently included in a Sybase policy type You can use this method only if you are pushing from a master server For information on this method see ldquoPushing the Software to All Clients Currently Specified in a Sybase Policy Typerdquo on page 15

14 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 25: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

Distribute to selected clients This method distributes the NetBackup for Sybase software to selected clients only If you are performing a new installation and you plan to add clients to a Sybase 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 60 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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Pushing the Software to All Clients Currently Specified in a Sybase Policy Type

Use the following procedure if you want to install or upgrade the NetBackup for Sybase software on all clients currently configured in a Sybase policy type You can use this procedure only from a master server

To push the software to all clients specified in a Sybase policy type

Note If you are pushing the NetBackup for Sybase 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

usropenvnetbackupbinupdate_dbclients Sybase 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 Sybase 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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 15

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 26: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 ldquoPushing the Software to New or Selected Clientsrdquo on page 18

To exit this procedure if there is only one client type n To install the software in this situation use ldquoPushing the Software to New or Selected Clientsrdquo on page 18

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 Sybase on a PC client from a UNIX server

The database agent does not support the clients platform type

The database agent software for that client type was not loaded onto the server in ldquoTo load the NetBackup for Sybase files on a UNIX serverrdquo on page 12

The client does not belong to a Sybase policy type

The skipped client list is in $TMPDIRskipped_clientsPID 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

16 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 27: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

Enter the number of simultaneous updates you wish to take place [1 - max] (default dflt)

max The maximum number of simultaneous updates that is allowed The value displayed ranges from 1 to 30

dflt 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 le number le 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 (yn) [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 $TMPDIRNB_DBCLIENT_LISTidentifier 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 usropenvshare that contains the version of NetBackup for Sybase that was installed

Chapter 2 Installation 17

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 28: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

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 Sybase 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 Sybase 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

usropenvnetbackupbinbpps

If the output shows that the bpdbm daemon is not running type the following command to start the daemon

usropenvnetbackupbininitbpdbm

2 Type the following command to change to the NetBackup bin directory

cd usropenvnetbackupbin

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

admincmdbpplclients -allunique -noheader gt file

If you are performing the install from a media server type the followingcommand

18 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 29: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

admincmdbpplclients -allunique -noheader -M ms_name gt file

ms_name Name of the NetBackup master server in this environment

file 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 usropenvnetbackupclient

op_systemThe operating system name For examples execute the ls(1) command in directoryusropenvnetbackupclienthardware

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 Sybase software

The host names of the clients must be the clientsrsquo 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 hostnamedomainname

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 Sybase -ClientList file

6 Answer questions as prompted by the update_dbclients command

Chapter 2 Installation 19

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 30: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

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 15

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

Local Installation of NetBackup for Sybase

During a local installation the NetBackup for Sybase files are extracted and installed The local machine can be a client or a server that also happens to be a NetBackup for Sybase client

To install NetBackup for Sybase on a local machine

1 Review ldquoVerifying the Installation Prerequisitesrdquo on page 9

If you are installing NetBackup for Sybase on a clustered NetBackup server also see ldquoCluster Softwarerdquo on page 11

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 Sybase 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 Administratorrsquos 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

20 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 31: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

5 Verify that a registered and valid license key for NetBackup for Sybase 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 type the following command

usropenvnetbackupbinadmincmdget_license_key

When the system prompts you type the host name of the NetBackup master server

Open the NetBackup Administration Console and choose Help gt License Keys

If the NetBackup master server is part of a NetBackup cluster the license key must be registered on each node

6 (Conditional) Log out of the media server or master server and return to the local client

Perform this step if you logged into a media server or the master server in step 4 to verify the license

7 Mount the CD-ROM

For more information on how to mount a CD-ROM see the NetBackup Installation Guide

8 Change the working directory to the CD-ROM directory

For example

cd CD_mount_point

9 Load and install the software by running the install script

Note Make sure that the NetBackup for Sybase version is the same version as the NetBackup client software

Type the following command

install

a Select the NetBackup Database Agent Software option

The following prompt appears

Do you want to do a local installation (yn) [n]

b Answer y

Chapter 2 Installation 21

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 32: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

A menu of all database agents available on the CD-ROM displays

c Select the NetBackup for Sybase option

d Type q to quit selecting options

A prompt appears asking if the list is correct

e Answer y

The following actions occur

The script writes the version file a tar(1) file compressed with gzip(1) and the install_dbext script to directory usropenvnetbackupdbext

The install script automatically runs the install_dbext script

If install_dbext completes successfully it writes a version file in directory usropenvshare that contains the version of NetBackup for Sybase that was installed

f Type q to quit from the script

Note You do not need to run the cluster_config script after installing NetBackup for Sybase on a server that is part of a NetBackup cluster

10 (Conditional) Select another node upon which to install the software

Perform this step under the following circumstances

If you are installing the NetBackup for Sybase 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 10 for that node

If you have installed the software on all the inactive nodes select the active node and repeat step 3 through step 10 for that node

If you have installed on all the nodes proceed to step 11

11 (Conditional) Unfreeze the active node

Perform this step if you are installing the NetBackup for Sybase 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

22 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 33: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

For information on how to unfreeze the active node in your specific cluster environment see the NetBackup High Availability System Administratorrsquos Guide

Chapter 2 Installation 23

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 34: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Installing NetBackup for Sybase

Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)

Note These instructions apply only to HP Tru64 clients

For NetBackup for Sybase the Sybase Backup Server must be started with the following special environment variables

_RLD_ARGS=-taso

LD_LIBRARY_PATH=usropenvlib

The NetBackup for Sybase install script install_sybackup sets these environment variables in the Sybase login scripts These scripts are as follows

For Sybase 120 these login scripts are SYBASEsh for the Bourne shell or SYBASEcsh for the C shell

For Sybase 1192 these login scripts are profile for the Bourne shell or cshrc for the C shell

All of these login scripts are located in the Sybase home directory

The user must invoke one of these login scripts so that the userrsquos environment is configured correctly before the Sybase Backup Server is started If the userrsquos environment is not configured correctly before Sybase Backup Server is started one of the following errors is reported when a backup is attempted from NetBackup for Sybase

Backup Server 4145273 [0] Error for device sybackup-SERV -SCHED Default-Application-Backup00 Pipe IO returned 0 bytes Backup Server Internal Error 46234 Multibuffering subprocesses died archive sybackup-SERV -SCHED Default-Application-Backup00 Backup Server 4141266 [0] The write call failed for device sybackup-SERV -SCHED Default-Application-Backup00 with error number 32 (Broken pipe) Refer to your operating system documentation for further details

Backup Server 412421 Archive API error for device=sybackup-SERV -SCHED Default-Application-Backup00 Vendor application name=ltUNINITgt Library version=0 API routine=ltUNINITgt Message=Unable to open API library for device sybackup-SERV -SCHED Default-Application-Backup Library path is dbsybase1200ASE-12_0liblibsybackupso dlopen() returned Code=22 Message=dlopen cannot load dbsybase1200ASE-12_0liblibsybackupso

After installing or upgrading NetBackup for Sybase stop and restart the Sybase Backup Server with these environment variables to minimize problems

24 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 35: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Specifying the Sybase Home Path

Specifying the Sybase Home Path

After you install NetBackup for Sybase perform this additional setup step that provides NetBackup for Sybase with information about your Sybase environment

To specify the Sybase home path

1 Change to the following directory

usropenvnetbackupbin

2 Run the following command

sybase_config

The following appears

Please specify the Sybase instance home path name

3 Supply the appropriate home path name and press Enter

The following appears

Do you have other Sybase instances (yn) [n]

4 Add other Sybase instances as appropriate or enter n if you are finished

Adding New Sybase Instances

If you add a new Sybase instance after you install NetBackup for Sybase follow the procedure described in ldquoSpecifying the Sybase Home Pathrdquo on page 25 This ensures that all new database instances are included in the NetBackup for Sybase backup operations

Chapter 2 Installation 25

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 36: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Adding New Sybase Instances

26 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 37: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuration

3

Before attempting to configure NetBackup for Sybase complete the procedure described in ldquoInstallationrdquo on page 9

The following steps outline the configuration procedure

1 Configuring the Maximum Jobs Per Client

2 Configuring Backup Policies

3 Modifying the Backup Restore and Load Scripts

4 Configuring the bpconf File

5 Enabling Striped Dumps and Loads

6 Testing Configuration Settings

The following sections in this chapter describe each of these steps in detail

User Interface Terminology Notes

You can perform many of the configuration steps in this chapter from the NetBackup Administration Console on the master server Depending on your master serverrsquos platform the console is available in one or two forms NetBackup supports a Java interface for both Windows and UNIX master servers In addition NetBackup supports a Windows interface for Windows master servers

The Java and Windows interfaces are nearly identical but when there are interface differences in the configuration procedures this manual uses the following headings to identify the interface being described

From the Windows interface

From the Java interface

27

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 38: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring the Maximum Jobs Per Client

Configuring the Maximum Jobs Per Client

To configure the Maximum jobs per client

1 In the left pane of the NetBackup Administration Console expand Host Properties

2 Select Master Server

3 In the right pane double-click on the server icon

The Master Server Properties dialog box displays

4 In the Master Server Properties dialog box click Global Attributes

5 Change the Maximum jobs per client value to 99

The Maximum jobs per client specifies the maximum number of concurrent backups allowed per client The default is 1 You can use the following formula to calculate a smaller value

Maximum jobs per client = number_of_streams X number_of_policies

number_of_streams The number of backup streams between the database server and NetBackup Each separate stream starts a new backup job on the client

number_of_policies The number of policies of any type that can back up this client at the same time This number can be greater than one For example a client can be in two policies in order to back up two different databases These backup windows can overlap

Tip Enter a large enough value for the Maximum jobs per client attribute to meet the number of jobs executed by Sybase You might need to experiment with different values at your site

28 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 39: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

Configuring Backup Policies

A NetBackup policy defines the backup criteria for a specific group of one or more clients These criteria include

Storage unit and media to use

Policy attributes

Backup schedules

Clients to be backed up

The script files to be executed on the clients

To use NetBackup for Sybase you need to define at least one Sybase policy with the appropriate schedules A configuration can have a single policy that includes all clients or there can be many policies some of which include only one client

Most requirements for Sybase policies are the same as for file system backups In addition to the attributes described here there are other attributes for a policy to consider For configuration instructions and information on all the attributes available see the NetBackup System Administratorrsquos Guide Volume I

Note If you are going to perform striped dumps or loads see ldquoEnabling Striped Dumps and Loadsrdquo on page 49

Planning NetBackup for Sybase Policies and Schedules

The following table summarizes the types of NetBackup policies and schedules to create

For this type of data Specify this type Specify this type of schedule

of policy

Sybase database Sybase Required schedule

Application Backup (Default-Application-Backup)

Optional schedule (Note the following schedule is required if you want to perform scheduled backups)

Automatic Full Backup (for the database_dump)

Sybase transaction logs Sybase Required Schedule

Automatic Full for the transaction logs (trans_dump)

Chapter 3 Configuration 29

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 40: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

For this type of data Specify this type Specify this type of schedule

of policy

Sybase configuration Standard Optional schedules files

Full Backup

User Backup

These schedules are recommended for backing up your configuration files in case of a disaster For information on files to include in this policy see your database documentation

Adding a New Policy

To add a new policy

1 Log on to the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 If your site has more than one master server choose the one on which you want to add the policy

4 From the Windows interface In the left pane right-click Policies and choose New Policy

From the Java interface In the left pane click Policies In the All Policies pane right-click the master server and click New

The Add a New Policy dialog box displays

5 In the Policy name field type a unique name for the new policy

6 Click OK

A dialog box displays in which you can specify the general attributes for the policy

7 From the Policy Type box select the Sybase policy type

Note The Sybase policy type does not appear in the drop-down list unless your master server has a license key for NetBackup for Sybase

30 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 41: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

8 Complete the entries on the Attributes tab For more information see ldquoDescription of Attributesrdquo which follows this procedure

9 Add other policy information

To add schedules see ldquoAdding Schedulesrdquo on page 31

To add clients see ldquoAdding Clientsrdquo on page 36

To add scripts to the Backup Selections list see ldquoAdding Backup Selectionsrdquo on page 37

10 When you have added all the schedules clients and Backup Selections you need click OK The new policy is created

Description of Attributes

With a few exceptions NetBackup manages a database backup like a file system backup The following table shows the policy attributes that are different for Sybase backups This information is used when you are adding a new policy

Other policy attributes vary according to your specific backup strategy and system configuration For more information on policy attributes see the NetBackup System Administratorrsquos Guide Volume I

Description of Policy Attributes

Attribute Description

Policy type Determines the types of clients that can be in the policy and in some cases the types of backups that NetBackup can perform on those clients To use NetBackup for Sybase you must define at least one policy of type Sybase

Keyword phrase For NetBackup for Sybase the Keyword phrase entry is ignored

Adding Schedules

Each policy has its own set of schedules These schedules initiate automatic backups and specify when a user can initate operations

A Sybase backup requires an Application Backup schedule which is created automatically when you create a Sybase policy The Application Backup schedule manages the backup operation You also need one or more automatic backup schedules if you plan to have NetBackup perform automatic or scheduled backups

Chapter 3 Configuration 31

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 42: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

To configure an Application Backup schedule

1 In the Policy dialog click the Schedules tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Double-click on the schedule named Default-Application-Backup

A dialog box displays The title bar shows the name of the policy to which you are adding the schedule

All Sybase backup operations are performed through NetBackup for Sybase using an Application Backup schedule This includes backups that start automatically

Configure an Application Backup schedule for each Sybase policy you create If you do not do this you cannot perform a backup To help satisfy this requirement an Application Backup schedule named Default-Application-Backup is automatically created when you configure a new Sybase policy

3 Specify the other properties for the schedule as explained in ldquoSchedule Propertiesrdquo on page 34

The backup window for an Application Backup schedule must encompass the time period during which all NetBackup for Sybase jobs scheduled and unscheduled can occur This is necessary because the Application Backup schedule starts processes that are required for all NetBackup for Sybase backups including those started automatically

For example assume the following

Users perform Sybase backup operations during business hours 0800 to 1300

Automatic backups that use this policy commence between 1800 and 2200

The Application Backup schedule must have a start time of 0800 and a duration of 14 hours

Example Settings for an Application Backup schedule

Type of Backup Schedule settings Description Settings

Application Backup

Retention The length of time the backup images are retained in the NetBackup catalog for restore

2 weeks

Backup Window The time during which a NetBackup operation can be initiated

Sunday through Saturday

000000 - 240000

32 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 43: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

Tip Set the time period for the Application Backup schedule for 24 hours per day seven days per week This ensures that your NetBackup for Sybase operations are never locked out due to the Application Backup schedule

To configure an automatic backup schedule

Generally you configure two Automatic Backup schedules for each Sybase database one for the database dump backups and one for the transaction log backups

1 On the Policy dialog click the Schedules tab

2 Click New

A dialog box displays The title bar shows the name of the policy to which you are adding the schedules

3 Specify a unique name for the schedule

4 Select the Type of backup

For information on the types of backups available for this policy see ldquoTypes of Backup Schedulesrdquo on page 34

5 Specify the other properties for the schedule as explained in Schedule Properties which follows this procedure

The following table shows example settings for an automatic backup schedule

Example Settings for an Automatic Backup Schedule

Type of Backup Schedule settings Description Settings

Automatic Backup Retention The length of time to store the record of a backup which NetBackup uses to determine if the schedule needs to be run

2 weeks

Frequency Frequency determines how often a backup should be performed

every week

Backup Window The time during which a NetBackup operation can be initiated

Sunday 180000 shy220000

6 If this is the last schedule click OK To add other schedules repeat step 1 through step 6

Chapter 3 Configuration 33

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 44: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

Types of Backup Schedules

You can perform backups with the following types of schedules

Sybase Backup Types

Application Backup The Application Backup schedule enables user-controlled NetBackup operations from the client both those initiated from the client and those initiated by an automatic schedule on the master server NetBackup uses the Application Backup schedule when the Sybase user starts a backup manually Configure at least one Application Backup schedule for each Sybase policy The Default-Application-Backup schedule is configured automatically as an Application Backup schedule

Automatic Backup An Automatic Backup schedule specifies the dates and times for NetBackup to automatically start backups by running the Sybase scripts in the order that they appear in the file list If there is more than one client in the Sybase policy the Sybase scripts are run on each client

Schedule Properties

Some of the schedule properties have a different meaning for database backups than for a regular file system backup The following table explains the schedule properties

Description of Schedule Properties

Property Description

Type of backup

Frequency

Calendar

Specifies the type of backup that this schedule controls The selection list shows only the backup types that apply to the policy you are configuring

For more information see ldquoTypes of Backup Schedulesrdquo on page 34

This setting is used only for scheduled backups and not for user-directed backups Frequency specifies the period of time that can elapse until the next backup or archive operation begins on this schedule For example if the frequency is seven days and a successful backup occurs on Wednesday the next full backup does not occur until the following Wednesday Typically incremental backups have a shorter frequency than full backups

This setting is used only for scheduled backups It is not used for user-directed backups The Calendar option allows you to schedule backup operations based on specific dates recurring week days or recurring days of the month

34 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 45: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

Description of Schedule Properties (continued)

Property Description

Retention Frequency-based scheduling

The retention period for an Application Backup schedule refers to the length of time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred

Set a retention period that is longer than the frequency setting for theschedule For example if the frequency setting is set to one week set the retention period to be more than one week The NetBackup schedulercompares the latest record of the Automatic Backup schedule to thefrequency of that Automatic Backup schedule to determine whether abackup is due This means that if you set the retention period to expire therecord too early the scheduled backup frequency is unpredictable However if you set the retention period to be longer than necessary the NetBackup catalog accumulates unnecessary records

Calendar-based scheduling

The retention period for an Application Backup schedule refers to the lengthof time that NetBackup keeps backup images

The retention period for an Automatic Backup schedule controls how longNetBackup keeps records of when scheduled backups have occurred However this setting is not significant for calendar-based scheduling

Multiple copies If you want to specify multiple copies for your Sybase policy configure Multiple copies on the Application Backup schedule

Other schedule properties vary according to your specific backup strategy and system configuration For more information on schedule properties consult the NetBackup System Administratorrsquos Guide Volume I

Chapter 3 Configuration 35

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 46: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

Adding Clients

The client list is the list of clients on which your Sybase backup scripts are run during an automatic backup A NetBackup client must be in at least one policy but can be in more than one

The following software must be installed on the client

Sybase

NetBackup client or server

NetBackup for Sybase

The backup and restore Sybase script(s)

To add clients to a policy

1 In the Policy dialog click the Clients tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Enter the name of the client you want to add

If Sybase is installed in a NetBackup cluster specify the virtual Sybase name as the client name

From the Windows interface

Type the name into the client list and press Enter

If NetBackup cannot detect the hardware and operating system a dialog box displays so you can specify this information

OR

Click the Browse for Computer button to choose the client from the network

From the Java interface

a The Add Client dialog box displays In the Client name field type the name of the client you are adding

b Choose the Hardware and operating system type and click Add

4 To add another client repeat step 2 and step 3

5 If this is the last client click OK

36 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 47: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

Adding Backup Selections

The backup selections list in a database policy has a different meaning than for non-database policies For example in a Standard policy the list contains files and directories to be backed up In a NetBackup for Sybase database policy you specify scripts to be run

Observe the following when using scripts

Make sure the scripts reside on each client in the client list Scripts can reside in any location Make sure that NetBackup can access the location you choose and that NetBackup can run the scripts

NetBackup installs sample scripts when you install the software and you can modify these scripts for your own use As part of the modification process write the scripts to a location outside of the original installation location so future NetBackup installations do not overwrite your sitersquos scripts

If you are using NetBackup for Sybase in a NetBackup server cluster make sure that the scripts reside in a location that is available after a failover

Add scripts only if you are setting up a policy for automatic scheduling All scripts listed in the backup selections list are run for manual backups and for Automatic Backup schedules as specified under the Schedules tab NetBackup runs the scripts in the order that the scripts appear in the Backup Selections list

For more information on backup scripts see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

To add scripts to the backup selections list

The following steps show how to perform this procedure from both the Java interface and from the Windows interface

Caution Be sure to specify the correct script names in the Backup Selections list to prevent an error or possibly a wrong operation Make sure that the script resides on the client before you try to add it to the Backup Selections list

From the Java interface

1 Open the Policy dialog

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click the Backup Selections tab

Chapter 3 Configuration 37

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 48: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring Backup Policies

3 Click New

A dialog box displays

4 Specify the names of the scripts that you want NetBackup to use

a In the Script box type the full path name of a script on the client

For example

backup_scriptsdbcold_backupsh

b Click Add to add the script to the list

c Repeat step a and step b until all scripts are added

5 Click OK

From the Windows interface

1 In the Policy dialog click the Backup Selections tab

To access the Policy dialog double-click the policy name in the Policies list in the NetBackup Administration Console

2 Click New

3 Specify the names of the scripts you want NetBackup to use

Use one of the following methods

Type the full path name of the script on the client

For example

backup_scriptsdbcold_backupsh

Click the Remote Folder button

The Browse window displays the hosts in the client list Navigate to and select the script file Click OK

4 Click OK

38 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 49: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

Modifying the Backup Restore and Load Scripts

Sybase SQL scripts cause the SQL Server to send directives that initiate a dump or load of the specified database or transaction log to the Sybase backup server The Sybase isql utility communicates with the SQL server For more information about the isql utility see your Sybase documentation

NetBackup for Sybase includes the following example scripts

sybase_mydb_backup

sybase_mydb_restore

sybase_mydb_load

The NetBackup for Sybase installation process writes these example scripts to the following location

usropenvnetbackupextdb_extsybasescripts

Each script can perform multiple Sybase backup server operations but each type of operation requires a separate script For example you need to use separate scripts for backups versus restores

Caution Always specify the correct script when configuring automatic backups or when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

The following sections show how to modify these scripts for your environment

Chapter 3 Configuration 39

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 50: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

Modifying the Backup Script

To modify the sybase_mdb_backup script

1 Copy the example script to a different location on your client

Sybase backup scripts can be located anywhere on a client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 sybase_mydb_backup

3 Use a text editor to open the sybase_mydb_backup script

The following example uses the vi(1) text editor

vi sybase_mydb_backup

4 Modify the sybase_mydb_backup script using the instructions in the script itself

When customizing this script note the following line

Replace database_dump below with your actual schedule nameif [ $SYBACKUP_SCHED = database_dump ]

Replace database_dump with the name of the Automatic Backup schedule used when setting up the NetBackup configuration in ldquoConfiguring Backup Policiesrdquo on page 29

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_backup script

Replace usrsybase12 below with the actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with the actual name of the SQL ServerSYBSERVER=SYBASE12

Replace SYB_DB below with the actual name of your Sybase database

40 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 51: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

DATABASE_NAME=SYB_DB

Replace syb_files below with your actual name of the NetBackup server Policy to be used to backup the directory with Sybase script filesSYB_FILES_POLICY=syb_files

Replace usrsybase12scripts below with your actual path of the Sybase files SYB_FILES_DIR=usrsybase12scripts

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCSfi

echo Started `date`SYBASE=$SYBASE export SYBASE These environment variables are set by NetBackup echo SYBACKUP_SERVER = $SYBACKUP_SERVERecho SYBACKUP_POLICY = $SYBACKUP_POLICYecho SYBACKUP_SCHED = $SYBACKUP_SCHEDecho SYBACKUP_SCHEDULED = $SYBACKUP_SCHEDULEDecho SYBACKUP_USER_INITIATED = $SYBACKUP_USER_INITIATED

RETURN_STATUS=0

Replace database_dump below with your actual NetBackup schedule name which is used for a full backup of the Sybase databaseif [ $SYBACKUP_SCHED = database_dump ]then NetBackup has started a database_dump backup DUMP_TYPE=DATABASE

else NetBackup has started a transaction log backup DUMP_TYPE=TRANSACTIONfi

Chapter 3 Configuration 41

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 52: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo dump $DUMP_TYPE $DATABASE_NAME to sybackup-SERV $SYBACKUP_SERVER -POL

$SYBACKUP_POLICY -SCHED Default-Application-Backup gt syb_$DATABASE_NAME_dump

Remove the from the beginning of the line below if you are going to use multiple stripes for the backup Repeat this line for each stripe Replace Default-Application-Backup below with your actual NetBackup Application Backup type schedule name for the Sybase database echo stripe on sybackup-SERV $SYBACKUP_SERVER -POL $SYBACKUP_POLICY -SCHED Default-Application-Backup gtgt syb_$DATABASE_NAME_dump

echo go gtgt syb_$DATABASE_NAME_dump

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt

syb_$DATABASE_NAME_dump

$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt syb_$DATABASE_NAME_dumpRETURN_STATUS=$

if [ $DUMP_TYPE = DATABASE ]then Initiate a backup of any file related to the Sybase database such as script files

echo bpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRusropenvnetbackupbinbpbackup -c $SYB_FILES_POLICY $SYB_FILES_DIRBPBACKUP_STATUS=$

if [ $BPBACKUP_STATUS -ne 0 ]thenecho echo bpbackup of $SYB_FILES_DIR returned $BPBACKUP_STATUS

fifi

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

42 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 53: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

Modifying the Restore Script

To modify the sybase_mydb_restore script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_restore script

The following example uses the vi(1) text editor

vi sybase_mydb_restore

4 Modify the sybase_mydb_restore script using the instructions in the script itself

5 Save and close the file

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

The following code example shows the sybase_mydb_restore script

Replace usrsybase12 below with your actual Sybase home directory SYBASE=usrsybase12

Replace SYBASE12 below with your actual name of the SQL ServerSYBSERVER=SYBASE12

if [ -d $SYBASEASE-12_0 ]then Sybase 1192 or earlier ASE_QUAL=OCS_QUAL=else Sybase 120 or later SYBASE_ASE=ASE-12_0 export SYBASE_ASESYBASE_OCS=OCS-12_0 export SYBASE_OCSASE_QUAL=$SYBASE_ASEOCS_QUAL=$SYBASE_OCS

Chapter 3 Configuration 43

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 54: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

fi

Replace usropenvnetbackupextdb_extsybasescriptssybase_mydb_load below with your actual SQL script path which contains corresponding LOAD commandsLOADDB=usropenvnetbackupextdb_extsybasescriptssybase_mydb_load

echo Started `date`

SYBASE=$SYBASE export SYBASE

RETURN_STATUS=0

NetBackup has started a restore

Replace manager with your Sybase server Administrators Passwordecho $SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB$SYBASE$OCS_QUALbinisql -Usa -Pmanager -I$SYBASEinterfaces -S$SYBSERVER lt $LOADDB

RETURN_STATUS=$

echo Finished `date`

echo exit $RETURN_STATUSecho

exit $RETURN_STATUS

44 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 55: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

Modifying the Load Script

To modify the sybase_mydb_load script

1 Copy the example script to a different location on your client

Sybase restore and load scripts can be located anywhere on the client If you do not copy the scripts to a site-specific location subsequent NetBackup upgrades can overwrite your sitersquos scripts

2 Set the access permissions of the script to 775

chmod 775 script_name

3 Use a text editor to open the sybase_mydb_load script

The following example uses the vi(1) text editor

vi sybase_mydb_load

4 Modify the sybase_mydb_load script which is as follows

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525goload transaction mydb from sybackupSYBASE12mydbT04453221-12-2001220100goload transaction mydb from sybackupSYBASE12mydbT01414222-12-2001204500goonline database mydb

a Replace mydb with the name of the database

b Replace the file name shown here as SYBASE12 with the name obtained from the bplist command

The file name portion of the load command begins after the two colons ()

For information about how to obtain the file name see ldquoBrowsing Backupsrdquo on page 56

For more information about the format of the file name see the technical overview in ldquoNetBackup for Sybaserdquo on page 6

c (Optional) Use the -SERV option to specify the NetBackup server on the device string of the load command The -SERV option which in this example specifies saturn overrides any server that is specified in the bpconf file For example

load database mydb from sybackupSYBASE12mydbD02431220-12-2001230525 -SERV saturn

5 Save and close the file

Chapter 3 Configuration 45

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 56: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Modifying the Backup Restore and Load Scripts

6 Test the script you modified

For information on testing scripts see ldquoTesting Configuration Settingsrdquo on page 51

Environment Variables

When a schedule runs NetBackup sets environment variables for the scripts to use when performing the backup These environment variables are as follows

Environment Variable Purpose

$SYBACKUP_SERVER Name of the NetBackup server

$SYBACKUP_POLICY Name of the NetBackup policy

$SYBACKUP_SCHED Name of the Automatic Backup schedule

$SYBACKUP_SCHEDULED Set to 1 if this is a scheduled backup (Automatic Backup)

$SYBACKUP_USER_INITIATED Set to 1 if this is a user-initiated backup (Application Backup backup)

Note The $SYBACKUP_POLICY and $SYBACKUP_SCHED variables are set only if the backup is initiated from the server either automatically by the NetBackup scheduler or manually through the administrator interface

46 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 57: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring the bpconf File

Configuring the bpconf File

When a NetBackup for Sybase operation is initiated NetBackup searches the configuration files for the policy server and schedule definitions in the following order

1 $SYBASE_HOMEbpconf

2 usropenvnetbackupbpconf

NetBackup searches the configuration for policy server and schedule definitions In case of conflicts the order of precedence is as follows

1 Command line options

2 Script variables

3 Environment variables

4 $USERbpconf (UNIX clients)

5 usropenvnetbackupbpconf (UNIX clients) or the NetBackup client configuration (Windows clients)

6 Built-in variables

NetBackup uses a policy or schedule configured in the NetBackup client configuration for all backups on the client including file system and Sybase database backups For this reason if a policy or schedule that is not a Sybase policy is configured in the NetBackup client configuration use the -POLICY and -SCHED options on the Sybase DUMP command to specify the correct policy or schedule For information on how to specify a policy or schedule on the Sybase DUMP command see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

If NetBackup fails to find policy and schedule definitions NetBackup for Sybase defaults to the first policy and schedule with the appropriate policy type

The following sections explain how to enable the bpconf files

Creating a $SYBASE_HOMEbpconf File on the Client

By configuring these bpconf options you ensure that NetBackup for Sybase uses the correct Sybase policy and schedule for your Sybase backups

Chapter 3 Configuration 47

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 58: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Configuring the bpconf File

To create a $SYBASE_HOMEbpconf file

1 Create a bpconf file in your Sybase home directory

For example if $SYBASE_HOME is sybase you create the following file

sybasebpconf

2 Define the policy and schedule in the bpconf file

Add the following parameters

BPBACKUP_POLICY=policy_nameBPBACKUP_SCHED=schedule_name

policy_name Specify the name of the Sybase policy you want to use

schedule_name Specify the name of the Application Backup schedule you want to use

Note NetBackup uses the $SYBASE_HOMEbpconf file only for Sybase policies

Specifying Options in usropenvnetbackupbpconf on the

Client

To specify files in usropenvnetbackupbpconf

Add a $SYBASE_HOME option to the usropenvnetbackupbpconf file on the client

$SYBASE_HOME must be your Sybase SQL Server home directory For example if $SYBASE_HOME is equal to sybase add the following line to the bpconf file

$SYBASE_HOME=sybase

48 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 59: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Enabling Striped Dumps and Loads

Enabling Striped Dumps and Loads

NetBackup for Sybase supports the Sybase Backup Serverrsquos ability to open multiple streams simultaneously to perform parallel dumps and loads All streams must be available simultaneously before the dump or load can proceed In addition the number of stripes specified during a load should match that of the dump

Example Scripts for Striped Dumps and Loads

The following is an example Sybase SQL backup script for a Sybase striped dump

dump database mydb to sybackupstripe on sybackupstripe on sybackupgo

The following is an example Sybase SQL load script for a Sybase striped load

load database mydb fromsybackupSYBASE11mydbD02799720-10-1997105552stripe on sybackupSYBASE11mydbD12799920-10-1997105552stripe on sybackupSYBASE11mydbD22800120-10-1997105552go

For more information see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39

Multiplexing Considerations - Duplicating Tapes

If you duplicate a tape with backup files on it that was created with Sybase striping and the NetBackup multiplex feature make sure to use multiplexing when duplicating the tape

Caution NetBackup tape duplication must be performed with the multiplex option when Sybase striping and the NetBackup multiplex (MPX) feature are used for a Sybase backup A problem occurs when multiple Sybase stripes are multiplexed to a single tape and then the tape is duplicated without using the -mpx option The duplicated tape must be created with the -mpx option on the bpduplicate command This is also accessible as the Preserve multiplexing checkbox on the Duplicate Backup Images window In addition all of the backups from the original Sybase multiplexing session must be included in the duplicated multiplexed group

Chapter 3 Configuration 49

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 60: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Enabling Striped Dumps and Loads

Multiplexing Considerations - Using more than 12 Stripes

If multiplexing striped Sybase database backups you might require a special configuration to restore them By default when restoring from multiplexed backups NetBackup uses twelve data buffers This is enough unless you are using more than twelve stripes If you are using more than 12 stripes use the following procedure to increase the number of data buffers used by NetBackup

To increase the amount of data buffers for a restore

1 On the master server use vi(1) or another text editor to create file usropenvnetbackupdbconfigNUMBER_DATA_BUFFERS_RESTORE

2 In the file enter an integer to specify the number of buffers

This number is the only entry in the file

3 Save and close the file

Make sure that editor does not save the file with any file extensions

50 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 61: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Testing Configuration Settings

Testing Configuration Settings

After configuring the master server for NetBackup for Sybase test the configuration settings by performing a manual backup (or backups) using the automatic backup schedules you have created

To test the configuration settings

1 Log onto the master server as administrator (Windows) or root (UNIX)

2 Start the NetBackup Administration Console

3 In the left pane click Policies

From the Windows interface The policy list appears in the right pane

From the Java interface The right pane splits into an All Policies pane and a details pane

4 Click the policy you want to test

5 Choose Actions gt Manual Backup

The Manual Backup dialog box appears

The Schedules pane contains the name of an automatic schedule (or schedules) configured for the policy that you are going to test The Clients pane contains the name of the client(s) listed in the policy that you are going to test

6 Follow the directions in the Manual Backup dialog box

7 Click Activity Monitor on the NetBackup Administration Console

If the manual backup does not exit with a successful status see ldquoTroubleshootingrdquo on page 59

For a description of status codes and other troubleshooting information see the NetBackup Troubleshooting Guide

Chapter 3 Configuration 51

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 62: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Testing Configuration Settings

52 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 63: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Using NetBackup for Sybase

4

After completing the installation and configuration you can use the NetBackup interfaces to start Sybase backups and restores You can also issue DUMP and LOAD commands directly from the isql utility to perform Sybase backups and restores

Caution Always specify the correct Sybase script when starting operations through NetBackup NetBackup for Sybase does not generate an error if a restore script is used for a backup operation or a backup script is used for a restore operation

This chapter contains the following sections

Performing a Backup

Browsing Backups

Performing a Restore

53

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 64: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Performing a Backup

Performing a Backup

There are two types of Sybase backups full and incremental

A full backup copies the entire database including both the data and the transaction log This is accomplished by performing a database dump

An incremental backup copies the transaction log that contains the database changes made since the last database or transaction log dump You can run a transaction log dump only if the database stores its log on a separate segment

Backup Strategy

One of the major tasks in developing a backup plan is to determine how often to back up your databases The backup strategy in this section is an example For guidelines on developing your own backup and recovery plan refer to your Sybase documentation

The frequency of your backups determines how much work you can restore in the event of a disaster Dump each database just after you create it to provide a base point and then dump it on a fixed schedule thereafter

The following is an example database backup strategy

1 Perform a full database backup by running a database dump every Friday night

2 Back up your Sybase configuration files every Friday night at the same time as the full-database backup

Sybase recommends that you save all the Sybase scripts This includes scripts that contain the disk init create database and alter database commands

Sybase also recommends that you save a hard copy of your sysdatabases sysusages and sysdevices tables each time you issue one of these commands In addition keep a copy of the syslogins

3 Perform an incremental backup each night by running a transaction log dump

Automatic Backup of a Sybase Database

The most convenient way to back up your database is to set up schedules for automatic backups When the NetBackup scheduler invokes a schedule for an automatic backup the Sybase backup scripts run in the same order as they appear in the file list The scheduler tries to find each script and it runs the scripts that it finds

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

54 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 65: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Performing a Backup

Manual Backup of a Sybase Database

To back up a Sybase database manually

1 (Optional) Issue the Sybase DBCC command to check database consistency

Database consistency is needed to ensure consistent and accurate backups If the database is corrupt use the DUMP command The DUMP comand can complete successfully even if the database is corrupt

2 Log into the NetBackup master server as administrator (Windows) or root (UNIX)

3 Using the NetBackup Administration Console manually run an automatic backup schedule for the Sybase policy

For information on initiating a backup of a Sybase policy see ldquoTesting Configuration Settingsrdquo on page 51

User-Directed Backup

To perform a user-directed backup

1 (Optional) Issue the Sybase DBCC command to check the databasersquos consistency

2 Issue the Sybase DUMP command from the isql utility on the client

If the client name appears in one or more Sybase policies the Default-Application-Schedule that NetBackup uses is the first policy in alphabetical order

For example

dump transaction mydb to sybackupgo

For information on the isql utility and the DUMP command see your Sybasedocumentation

Chapter 4 Using NetBackup for Sybase 55

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 66: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Browsing Backups

Browsing Backups

You can use the bplist command to browse the Sybase backup history on the master server The result is the list of dump file names The following example bplist command searches all Sybase backups (dumps) for a client named copper on a server named candytuft

rootltcandytuftgt cd usropenvnetbackupbinrootltcandytuftgt bplist -S candytuft -C copper -t 7 -R sybase1200esamT02244826-10-2001134517sybase1200modelD02118226-10-2001125640sybase1200modelD02073026-10-2001124204sybase1200modelD02093226-10-2001123302sybase1200masterD12013826-10-2001072557sybase1200masterD21962026-10-2001072557sybase1200masterD32064026-10-2001072557sybase1200masterD01988826-10-2001072557sybase1200modelD01909226-10-2001071814sybase1192modelD0417225-10-2001071720rootltcandytuftgt

The -t 7 option on this command specifies the Sybase backups (dumps) The -R on this command specifies a recursive listing

For more information on this command see the bplist(1M) man page

Note NetBackup stores Sybase backups (dumps) in its catalog as dumpfile but when you specify a backup for the LOAD command you must use dumpfile without the slash

56 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 67: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Performing a Restore

Performing a Restore

The procedure for restoring a Sybase database depends on the database involved and the problems that you have on your system If the database and the device were lost

1 Initialize a new device

2 Re-create the database

For information on how to restore your database in each of the preceding situations see your Sybase documentation

The following example shows how to restore example database mydb to the level of a recent database dump plus two transaction log dumps

1 Execute the LOAD commands directly from SQL server

This loads the database dump and transaction log dumps

2 Check database consistency

When you have brought the database up-to-date use DBCC commands to check the consistency of the database

Using isql to Restore a Sybase Database

The steps required to recover a Sybase database depend on the database that is involved and the problem that you have on your system These steps can include

Using buildmaster installmaster and installmodel for system databases

Re-creating database devices

Re-creating databases

Loading database dumps

Applying transaction logs

For information on how to perform the preceding steps see your Sybase documentation

A load can take significantly longer than a dump The time required to load a database depends on the overall number of pages in the database The load database command loads all used pages from the dump into the target database and runs recovery of syslogs to ensure consistency The load process initializes any unused pages

You can load database and transaction dumps by manually submitting the Sybase LOAD command to SQL server

Chapter 4 Using NetBackup for Sybase 57

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 68: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Performing a Restore

The LOAD command must include the appropriate dump file name For information about editing the LOAD command with the correct dump file name see ldquoModifying the Backup Restore and Load Scriptsrdquo on page 39 Make sure to load the database dump and all of the transaction logs before bringing the database back online

For example

load database mydb from sybackupSYBASEmydbD01469312-12-1997092937 -SERV saturngo

Redirected Restore Configuration on the Client

If you want to browse and restore backups that are owned by another client perform the following steps

1 Ensure that the NetBackup server is configured to allow the redirected restore

For information see the NetBackup System Administratorrsquos Guide Volume 1

2 Specify either of the following (if you specify both NetBackup considers them in the order listed)

Specify the client name on the Sybase LOAD command with the -CLIENT and -SERV option For example the following command specifies saturn as the client to browse

load database mydb from sybackupSYBASEmydbD01469312-12-1997092837 -SERV candytuft -CLIENT saturngo

Specify the client name with the CLIENT_NAME option in the $HOMEbpconf or usropenvnetbackupbpconf file on the client For example the following command specifies saturn as the client to browse

CLIENT_NAME=saturn

58 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 69: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Troubleshooting

5

NetBackup NetBackup for Sybase and the Sybase Backup Server all provide reports on database backup and restore operations These reports are useful for finding errors associated with those applications

This chapter contains the following sections

NetBackup and NetBackup for Sybase Logs

Setting the Debug Level

Sybase Backup Server Log and Messages

Minimizing Timeout Failures on Large Database Restores

59

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 70: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup and NetBackup for Sybase Logs

NetBackup and NetBackup for Sybase Logs

The NetBackup server and client software allow you to enable detailed debugging logs The information in these log files can help you troubleshoot problems that occur outside of either NetBackup for Sybase or the Sybase Backup Server Note the following with regard to these logs

These logs do not reveal errors that occur during the execution of the Sybase Backup Server unless those errors also affect NetBackup for Sybase Sybase might (or might not) write to the NetBackup for Sybase logs for errors in the application Your best sources for Sybase error information are the logs provided by Sybase

Generally each debug log corresponds to a NetBackup process and executable

For information about the debugging log files see the NetBackup Troubleshooting Guide and the usropenvnetbackuplogsREADMEdebug file

Enabling Logging

To enable the NetBackup for Sybase logs

1 Create the following directories on the client

usropenvnetbackuplogsbpbackupusropenvnetbackuplogsbpbkarusropenvnetbackuplogsbphdbusropenvnetbackuplogsbprestoreusropenvnetbackuplogstarusropenvnetbackuplogssybackup

For example

cd usropenvnetbackuplogsmkdir bphdb

2 Set the access permissions to 777 on these log directories

For example

chmod 777 bphdb

3 Enable logging for the nbpem nbjm and nbrb scheduling processes which use unified logging

NetBackup writes unified logs to usropenvlogs on UNIX and to install_pathNetBackuplogs on Windows You do not need to create log directories for processes that use unified logging For information on using logs and reports see the NetBackup Troubleshooting Guide

60 NetBackup for Sybase System Administratorrsquos Guide for UNIX

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 71: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

NetBackup and NetBackup for Sybase Logs

If you create a debug log directory on the client NetBackup for Sybase records the dump file name in the resulting debug log The debug log directory that you can create is as follows

usropenvnetbackuplogssybackup

NetBackup for Sybase sends an informational message that specifies the dump file name to Sybase Backup Server

Accessing the Log Files

The following sections describe the logs created when you create the log directories Use a text editor to view the contents of the logs

bphdb Directory on the Client

The usropenvnetbackuplogsbphdb directory contains the following types of logs

sybase_stdoutmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script output to this file

sybase_stderrmmddyy

Unless redirected elsewhere NetBackup writes Sybase backup script errors to this file

logmmddyy

bphdb is the NetBackup Database Backup binary This log contains debugging information for the bphdb process NetBackup for Sybase uses this client process for Sybase backup script execution It is invoked when an automatic backup schedule is run

sybackup Directory on the Client

The usropenvnetbackuplogssybackup directory contains the following execution log

logmmddyy

This log contains debugging information and execution status for the Sybase NetBackup client processes linked to the library program provided with NetBackup for Sybase

Chapter 5 Troubleshooting 61

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 72: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Setting the Debug Level

NetBackup Server Reports

NetBackup provides other reports that are useful in isolating problems One such report is All Logs Entries on the server For information on server reports see the NetBackup System Administratorrsquos Guide Volume I

Setting the Debug Level

You can control the amount of information written to the debugging logs in the usropenvnetbackuplogs directories by changing the debugging level The higher the value the more information is logged Typically the default value of 0 is sufficient However Technical Support might ask you to set the value higher when a problem is being analyzed You can set the debugging levels to 0 1 2 3 4 or 5 A level of 5 provides the most detail

To enable detailed logging

Enable detailed logging by entering the following line in the bpconf file

VERBOSE = 5

Sybase Backup Server Log and Messages

The Sybase Backup Server log provides information on the Sybase Backup Server part of the operation The database administrator can check this log to determine the ultimate success or failure of the database backups and restores

DUMP and LOAD Progress Messages

Sybase Backup Server sends its dump and load progress messages to the client that initiated the dump or load request When you use NetBackup to start Sybase backups NetBackup for Sybase writes Sybase Backup Server progress messages to the following file

usropenvnetbackuplogsbphdbsybase_stdoutmmddyyhhmmsstxt

If the usropenvnetbackuplogsbphdb location does not exist NetBackup for Sybase does not write the messages

62 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 73: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Minimizing Timeout Failures on Large Database Restores

Error Logging

Sybase Backup Server performs its own error logging in the file that you specify when you configure Sybase Backup Server For more information on this file see your Sybase documentation

Informational and error messages sent to the Sybase Backup Server log file include messages from the Archive API You can enable detailed diagnostic tracing for the Archive API by specifying the -DTRACEIO option on the backup server command line

Note To determine successful status of DUMP and LOAD commands always check Sybase Backup Server messages and logs

The following Sybase Backup Server message log indicates successful DUMP command completion

Backup Server 34311 Dump phase number 1 completedBackup Server 34311 Dump phase number 2 completedBackup Server 45811 Database model 238 kilobytes DUMPedBackup Server 34311 Dump phase number 3 completedBackup Server 45811 Database model 242 kilobytes DUMPedBackup Server 34211 DUMP is complete (database model)

Minimizing Timeout Failures on Large Database Restores

Large database restores sometimes fail when multiple restore sessions compete for resources In this situation a restore session can be delayed while waiting for media or device access If the delay is too long the restore session times out Use the following procedures to minimize session timeouts and to allow the restores to complete successfully

To minimize database session timeouts

1 In the NetBackup Administration Console expand NetBackup Management gt Host Properties gt Clients

2 Set the Client read timeout property to a large value

The default for the Client read timeout setting is 300 seconds (5 minutes) For database agent clients increase the value significantly from the value recommended in the NetBackup System Administratorrsquos Guide Volume 1 For example change this setting to 30-60 minutes to minimize timeout errors

3 Click OK for each client

Chapter 5 Troubleshooting 63

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 74: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Minimizing Timeout Failures on Large Database Restores

To minimize loading and unloading of tapes

You can minimize excessive unloading and reloading of tapes between multistreamed backups by making changes on the NetBackup media server

In the usropenvnetbackupbpconf file on the NetBackup media server add the following options

MEDIA_UNMOUNT_DELAY

MEDIA_REQUEST_DELAY Use this variable only with nonrobotic drives such as tape stackers

64 NetBackup for Sybase System Administratorrsquos Guide for UNIX

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 75: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

Index

A

accessibility features ixadding Sybase instances 25API

diagnosis tracking 63Remote Sybase Backup Server 7Sybase Backup Server archive API 6

Application Backup schedulebackup window 32configuring 32overview 32 34retention 32

automatic backupcreate scripts 39policy 54schedule

bphdb log 61name 46

specify correct script 53Automatic Backup schedule

overview 34automatic backup schedules

configuring 33

B

Backup Selections listadding selections 37overview 37

backups automatic

configure scripts 39using scripts 54

catalog 6full 54incremental 54manual 51restoring database backups 57sequence of operation 7strategy 54

user directed with isql 55backupserver command 63bpconf

administrator 64BPBACKUP_POLICY 47BPBACKUP_SCHED 47NetBackup policy 47NetBackup schedule 47Sybase home directory 47SYBASE_HOME option 48

bpbackup command 7bpdbm daemon 18bphdb

log 60 61process 7

bplist command 56bpplclients command 11 18 19bprestore command 7browsing backups 56

C

client list 15client read timeout property 63cluster software prerequisites 11cluster_config script 11 20 22commands

backupserver 63bpbackup 7bplist 56bpplclients 11 18 19bprestore 7DUMP 63get_license_key 13 21initbpdbm 18install_dbext 17 22LOAD 63sybase_config 25update_dbclients 11 15 19

compatibility information 9

65

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 76: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

configurationbpconf file 47database debug level 62environment variables 46LOAD command 45Media Manager 10striped dumps and loads 49

D

daemons see processesdata buffers 50database software prerequisites for

installation 10debug logs

description 60in usropenvnetbackuplogs 60

debugging level 62diagnosis tracking 63directory

bphdb for error messages 62debug log 60SYBASE_HOME 48

DUMP commanddump-device string 6executing 55function on servers 5

dump image 6dump-device string 6

E

environment variables 46error

logging 63messages 63script name 39

examples of script files 39

G

get_license_key command 13 21

H

HP Tru64 installation considerations 24

I

image dump 6informational messages 63initbpdbm command 18install script 13 21install_dbext command 17 22installation

database software prerequsites 10

local 20platform compatibility 9prerequisites 9prerequisites in a cluster 11remote 12requirements for NetBackup software 10

isql utilityrole in backup script use 7role in user-directed backups 55Sybase script 39

J

Java interface 27

L

licensing information 13 21LOAD command

dump-device string 6executing 55function on servers 5in scripts 45modifying 45

local installation procedure 20log files

accessing 61also see debug logsenabling 60Sybase Backup Server 62troubleshooting with log files 60

M

maximum jobs per client 28Media Manager

configuring backup media 10data buffers 50

messages 62multiple copies feature 35multiplexing

considerations when duplicating tapes 50overview 2

multistreamed backups 64

N

nbjm scheduling process 60nbpem scheduling process 60nbrb scheduling process 60NetBackup server LOAD command 45

P

parallel operations 7

66 NetBackup for Sybase System Administratorrsquos Guide for UNIX

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 77: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

platform compatibility 9 policy

bpconf 47for other Sybase files 54

policy configurationadding clients 36adding new 30attributes 31backup selections list 37overview 29planning 29schedules 31testing 51

Preserve Multiplexing option 49processes

bpdbm 18log files for NetBackup processes 61scheduling (nbpem nbjm nbrb) 60

progress message file 62

R

redirected restore 58remote folder button 38remote installation procedure 12Remote Sybase Backup Server 7reports

All Log Entries report 62also see log files 60creating for database operations 59NetBackup server reports 62

restoreprocedure 57redirected 58

retention periodfor frequency-based schedules 35

robust logging 60

S

scheduleautomatic backup 54bpconf 47LOAD command 45

schedulesadding 31frequency 34properties 34retention 35types of schedules 31

scriptsbackup 40

cluster_config 11 20 22customize 40definition 4example 39example script files 39install 13 21restore 43 45scheduler 54sequence of operation 7sybase_mydb_backup 39 40sybase_mydb_load 39 45sybase_mydb_restore 39 43type of operation 39usage caution 39 53

skipped clients 16SQL Server 4stopping and starting Sybase backup server

(Tru64 only) 24striping

backups 50enabling striped dumps and loads 29

Sybaseadding instances 25home path 25SQL script 4

Sybase Backup ServerAPI 6backup-catalog feature 6description 5DUMP and LOAD progress messages 62dump-file name 61error logging 63example message log 63interaction with SQL Server 4NetBackup backup 7parallel dumps and loads 49stopping and starting 24using scripts 39

sybase_config command 25sybase_mydb_backup script 39 40sybase_mydb_load script 39 45sybase_mydb_restore script 39 43sysdatabases 54sysdevices tables 54syslogins 54sysusages 54

T

tape duplication 49

Index 67

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index
Page 78: VERITAS NetBackup for Sybase - York · PDF filePreface This guide describes how to install, configure, and use NetBackup for Sybase on a UNIX platform. For information about the NetBackup

testing policy configuration 51 update_dbclients command 11 15 19 timeout failures minimizing 63 troubleshooting logs 60

W

Windows interface 27 U

unified logging 60

68 NetBackup for Sybase System Administratorrsquos Guide for UNIX

  • System Administratorrsquos Guide
    • Contents
    • Preface
      • Getting Help
        • Finding NetBackup Documentation
        • Accessing the VERITAS Technical Support Web Site
        • Contacting VERITAS Licensing
          • Accessibility Features
          • Comment on the Documentation
            • Introduction
              • NetBackup for Sybase Features
              • NetBackup for Sybase Terminology
              • NetBackup for Sybase Overview
                • SQL Server and Sybase Backup Server
                • NetBackup for Sybase
                • Sequence of Operation
                    • Installation
                      • Verifying the Installation Prerequisites
                        • Operating System and Platform Compatibility
                        • NetBackup Software
                        • Database Software
                        • Cluster Software
                          • Installing NetBackup for Sybase
                            • Remote Installation of NetBackup for Sybase
                              • Loading the NetBackup for Sybase Files onto the Server
                              • Pushing the Software to All Clients Currently Specified in a Sybase Policy Type
                              • Pushing the Software to New or Selected Clients
                                • Local Installation of NetBackup for Sybase
                                • Stopping and Starting the Sybase Backup Server (HP Tru64 Clients Only)
                                  • Specifying the Sybase Home Path
                                  • Adding New Sybase Instances
                                    • Configuration
                                      • User Interface Terminology Notes
                                      • Configuring the Maximum Jobs Per Client
                                      • Configuring Backup Policies
                                        • Planning NetBackup for Sybase Policies and Schedules
                                        • Adding a New Policy
                                          • Description of Attributes
                                            • Adding Schedules
                                              • Types of Backup Schedules
                                              • Schedule Properties
                                                • Adding Clients
                                                • Adding Backup Selections
                                                  • Modifying the Backup Restore and Load Scripts
                                                    • Modifying the Backup Script
                                                    • Modifying the Restore Script
                                                    • Modifying the Load Script
                                                    • Environment Variables
                                                      • Configuring the bpconf File
                                                        • Creating a $SYBASE_HOMEbpconf File on the Client
                                                        • Specifying Options in usropenvnetbackupbpconf on the Client
                                                          • Enabling Striped Dumps and Loads
                                                            • Example Scripts for Striped Dumps and Loads
                                                            • Multiplexing Considerations - Duplicating Tapes
                                                            • Multiplexing Considerations - Using more than 12 Stripes
                                                              • Testing Configuration Settings
                                                                • Using NetBackup for Sybase
                                                                  • Performing a Backup
                                                                    • Backup Strategy
                                                                    • Automatic Backup of a Sybase Database
                                                                    • Manual Backup of a Sybase Database
                                                                    • User-Directed Backup
                                                                      • Browsing Backups
                                                                      • Performing a Restore
                                                                        • Using isql to Restore a Sybase Database
                                                                        • Redirected Restore Configuration on the Client
                                                                            • Troubleshooting
                                                                              • NetBackup and NetBackup for Sybase Logs
                                                                                • Enabling Logging
                                                                                • Accessing the Log Files
                                                                                  • bphdb Directory on the Client
                                                                                  • sybackup Directory on the Client
                                                                                    • NetBackup Server Reports
                                                                                      • Setting the Debug Level
                                                                                      • Sybase Backup Server Log and Messages
                                                                                        • DUMP and LOAD Progress Messages
                                                                                        • Error Logging
                                                                                          • Minimizing Timeout Failures on Large Database Restores
                                                                                            • Index

Recommended