NetVault Backup Teradata Plugin Users Guide English

8/18/2019 NetVault Backup Teradata Plugin Users Guide English

1/110

TRG-101-12.2-EN-01 10/08/10

NetVault ®: BackupTeradata Plugin

version 12.2Version: 12.2Product Number: TRG-101-12.2-EN-01

User’s Guide


2/110

CopyrightsNetVault: Backup Teradata Plugin User’s Guide

Software Copyright © 2010 BakBone SoftwareDocumentation Copyright © 2010 BakBone Software

This software product is copyrighted and all rights are reserved. The distribution and sale of thisproduct are intended for the use of the original purchaser only per the terms of the License

Agreement. All other product trademarks are the property of their respective owners.

The NetVault: Backup Teradata Plugin User’s Guide documentation is copyrighted and all rightsare reserved.

This document may not, in whole or part, be copied, photocopied, reproduced, translated,reduced or transferred to any electronic medium or machine-readable form without prior consentin writing from BakBone Software.

Teradata, ARCmain, BTEQ and BYNET are registered trademarks of the TeradataCorporation. All references made within this documentation used with permission fromTeradata Corp.

THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIESOF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-

INFRINGEMENT.

THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICALERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESECHANGES WILL BE INCORPORATED INTO NEW EDITIONS OF THE PUBLICATION.BAKBONE SOFTWARE MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THEPRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS PUBLICATION AT ANYTIME.

© 1999-2010 BakBone ®, BakBone Software ®, NetVault ®, Application Plugin Module ™, BakBonelogo ®, Integrated Data Protection ™, SmartDisk ™, Asempra ®, and FASTRecover ™ are alltrademarks or registered trademarks of BakBone Software, Inc., in the United States and/or inother countries. All other brands, products or service names are or may be trademarks,registered trademarks or service marks of, and used to identify, products or services of theirrespective owners.

BakBone Software9540 Towne Centre Drive, Suite 100 San Diego, California 92121 866.484.2663


3/110


4/110

Table of Contents4

• Creating or Upgrading the Catalog Database ...............................................................31• Creating User Accounts for Parallel Restores .............................................................32

- Creating Restore Accounts ............................................................................................................ 33- Granting Privileges to the Accounts ............................................................................................... 34

• Defining Encryption Algorithms ....................................................................................35

Chapter 4: Backing up Data with Teradata Plugin 37

• Available Backup Methods .............................................................................................38- Full Backup .................................................................................................................................... 39- Full On-line Backup ........................................................................................................................ 39- Full Clustered Backup .................................................................................................................... 39- Full Clustered On-line Backup ....................................................................................................... 40 - Full Multi-stream Backup ............................................................................................................... 40 - Full Multi-stream On-line Backup ................................................................................................... 41- Incremental Backup ....................................................................................................................... 41- Data Dictionary Backup ................................................................................................................. 42 - User-defined Backup Scripts .........................................................................................................42

• Performing Full and Full On-line Backups ....................................................................42- Selecting Data for a Backup .......................................................................................................... 42 - Choosing the Backup Method ........................................................................................................45 - Configuring the Backup Options .................................................................................................... 45 - Choosing the BAR Server to Run Backup ..................................................................................... 48

- Finalizing and Submitting a Job ..................................................................................................... 48 • Performing Full Clustered and Full Clustered On-line Backups ................................49• Performing Full Multi-stream and Full Multi-stream On-line Backups .......................50• Archiving Selected Partitions of PPI Tables .................................................................52

- Considerations While Archiving Partitions ..................................................................................... 52 - Procedure for Backing up PPI Partitions ........................................................................................ 52 - Modifying the PPI Filter Expression ............................................................................................... 54- De-selecting PPI Partitions ............................................................................................................ 54

• Performing Incremental Backup ....................................................................................54• Backing up Only Data Dictionary ...................................................................................55• Resuming a Job From Last Checkpoint ........................................................................55• Generating ARC Scripts Only ........................................................................................56• Backing up Data with User Scripts ................................................................................57• Managing the Catalog Database ....................................................................................57

- Performing Catalog Database Maintenance from the Plugin GUI ................................................. 58 - Performing Catalog Database Maintenance from the CLI ............................................................. 58


5/110

NetVault: Backup Teradata PluginUser’s Guide

• Using Selection Sets ...................................................................................................... 59- Creating a Selection Set ................................................................................................................ 60 - Loading a Selection Set ................................................................................................................. 60

• Additional Notes .............................................................................................................60

Chapter 5: Restoring Data with Teradata Plugin 63

• Available Restore Methods ............................................................................................ 64- Restore .......................................................................................................................................... 64- Copy ............................................................................................................................................... 65 - Analyze .......................................................................................................................................... 65 - User-defined Restore Scripts ......................................................................................................... 65

• Restoring or Copying All-AMPs Archives .................................................................... 66- Selecting Data for a Restore ..........................................................................................................66 - Connecting to the Target DBS ....................................................................................................... 67 - Choosing the Restore Method ....................................................................................................... 67 - Configuring the Restore Options ....................................................................................................67 - Recovering Tables and Databases ................................................................................................ 69- Choosing the BAR Server to Run the Job ..................................................................................... 70 - Finalizing and Submitting a Job ..................................................................................................... 70

• Restoring or Copying Cluster Backups ........................................................................ 70• Restoring or Copying Multi-stream Archives ..............................................................72• Restoring or Copying Selected Partitions .................................................................... 74

• Restoring Incremental Backups ....................................................................................75• Restoring Dictionary Archives ...................................................................................... 76• Renaming Objects During Restore ............................................................................... 76• Copying Data to an Alternate Database ........................................................................ 78• Analyzing Archive Media ............................................................................................... 79• Generating ARC Script Only .......................................................................................... 80• Restoring Data with User Scripts .................................................................................. 80

- Restoring Data from User Script Backups ..................................................................................... 81- Restoring Data from Plugin Backups with User Scripts ................................................................. 81- Dumping Restore Map ................................................................................................................... 83

• Additional Features Available on the Selections Tab .................................................. 83• Additional Notes .............................................................................................................84

Chapter 6: Viewing Logs and Job Progress 87

• Monitoring Job Progress ............................................................................................... 87


6/110


7/110


8/110

Preface

8

Recommended Additional Reading

NetVault: Backup DocumentationNetVault ®: Backup Installation Guide – This guide provides completedetails on installing the NetVault: Backup Server and Client software.NetVault ®: Backup Administrator’s Guide – This guide describes how touse NetVault: Backup and provides comprehensive information on allNetVault: Backup features and functionality.

NetVault ®: Backup Configuration Guide – This guide explains how tochange the preferences and default settings for NetVault: Backup.

You can download these guides from the BakBone website at the followingaddress:

http://www.bakbone.com/documentation

Teradata Archive/Recovery Utility Reference Guide – This guide explainshow to use Teradata Archive/Recovery Utility (Teradata ARC) to archive,restore and recover Teradata database, and provides a detailed descriptionof the ARC commands.

http://www.info.teradata.com/DataWarehouse/eTeradata-BrowseBy.cfm?page=Teradata%20Tools%20and%20Utilities

Teradata Database Administration Guide – This guide provides informationon database administration tasks and tools, and explains how to create andmanage Teradata database objects.

http://www.info.teradata.com/DataWarehouse/eTeradata-

BrowseBy.cfm?page=Teradata%20Database

Technical Support

Teradata Telephone Support – The support information for the NetVault:Backup Teradata Plugin customers having a technical support contract withTeradata is given below:

U.S. Customers – Call 1 - 877 – 698 – 3282Outside U.S.A – Contact your local area representative. The relevanttelephone number may be found in your localized documentation.

BakBone Software Technical Support – The customers having directtechnical support contract with BakBone Software, Inc. can obtain worldwidetechnical support by telephone, via the web form or by e-mail. For completedetails, refer to BakBone’s corporate web site:

http://www.bakbone.com/support/support.aspTeradata Service and Support Links – Customer support is availablearound-the-clock, seven days a week. Trained professionals at Remote


9/110


Services Centers (RSC) are available to assist you. To learn more aboutTeradata Customer Services, go to Teradata @ Your Service at

http://www.Teradata.com/TeradataAtYourServiceRSCs were formerly called MSCs (Managed Service Centers).If you have purchased an ESS (Enterprise System Support) contract, acustomized support plan was created for you. Refer to your support plan forcontact information. In addition, a unique PIN (Personal IdentificationNumber) was given to your site. If you are an ESS customer, you mustcontact the regional RSC to request support, and you must use your PIN.PINs are not published; if you misplace your PIN contact your accountrepresentative.Teradata Information Links

Information Products Web Site – The Information Products site provides

Technical Documentation at URL:http://www.info.teradata.comTeradata Web Site – Provides the latest news, upcoming events, analystreports, benchmark publications, and customer stories – all tailored toyour industry, your business and your needs at URL:

http://www.teradata.comTeradata Resource Center Web Site – The latest Teradata Product andSolution brochures, Industry Solution brochures, as well as customersuccess stories and third party analyst reports at URL:

http://www.teradatalibrary.comData Storage products are listed at:

http://www.teradatalibrary.com/datastorage.htmBakBone Software Information and Downloads

Corporate Web Site – Information on general BakBone Softwareproducts can be obtained from our corporate web site, URL:

http://www.bakbone.comNetVault Teradata FTP Site – The latest information, technical manualsand NetVault software CERTIFIED for use with Teradata BAR Solutions isprovided in an FTP site, URL:

ftp://ftp.bakbone.com/public/teradataDownloads may be carried out via a web browser (recommended), or byusing an FTP client with login anonymous and password .


10/110

Preface

10


11/110


1

Chapter 1:

INTRODUCING N ET VAULTB ACKUP T ERADATA P LUGIN

This chapter provides an overview of the NetVault: Backup Teradata Plugin. Theinformation in this chapter is organized into the following topics:

NetVault: Backup Teradata Plugin – At a GlanceFeature Summary

1.1.0 NetVault: Backup Teradata Plugin – At a Glance

The NetVault: Backup Teradata Plugin (Teradata Plugin) makes backup andrecovery of Teradata database easy to perform and manage, allowing you toimplement your backup policies from a point-and-click GUI without any complexscripting. Utilizing Teradata Archive and Recovery Utility (ARC), the pluginautomatically generates ARC scripts for the backup and recovery of selecteddatabases, tables, PPI partitions and other database objects. You can choose the

All-AMPs method, or take advantage of parallelism provided by the Cluster andMulti-stream methods for increased throughput and fault tolerance while designingyour backup strategy. Support for granular restores reduces downtime and allowsyou to resume normal operations quickly in the unfortunate event of failure.

1.2.0 Feature Summary

All-AMPs, Cluster and Multi-stream methods for backing up and restoringdataFull, Full On-line, Full Clustered, Full Clustered On-line, Full Multi-stream andFull Multi-stream On-line backup typesIncremental backups of after-change journal imagesBackup and restore entire database, or selected tables and database objectsData Dictionary backup type

Parallel jobs for better performance and fault toleranceBackup encryption on Linux and WindowsCheckpoint restartsRoll forward with after-change journal imagesRestore data to alternate Teradata DBS configurationGenerate ARC scripts without actually running the jobs


12/110

Chapter 1Introducing NetVault: Backup Teradata Plugin

12

Analyze archive mediaRun user-defined ARC scriptsSingle point progress monitoring for parallel jobsJob schedulingIntegration with a wide range of backup devices

Intuitive point-and-click GUI


13/110


1

Chapter 2:

INSTALLING T ERADATA P LUGINThis chapter describes the pre-installation requirements, and the procedures forinstalling and removing the Teradata Plugin. The information in this chapter isorganized into the following topics:

Setting Up the Teradata Backup SystemPrerequisitesInstalling Teradata PluginInstalling the License KeyRemoving Teradata Plugin

2.1.0 Setting Up the Teradata Backup System

The Teradata backup system can be viewed as two possible architecture:

Traditional ArchitectureBAR Framework

2.1.1 Traditional ArchitectureThe traditional approach is the direct-attached architecture in which the tapedrives and libraries are connected directly to the Teradata nodes. The Teradata

Plugin runs on the DBS nodes, which initiate the backup and restore jobs.Figure 2-1:

An example of legacy direct-

attached configuration


14/110

Chapter 2Installing Teradata Plugin

14

Teradata has moved away from this architecture and does not recommend it to thenew customers. However, support will continue to protect the investment of theexisting customers. The direct-attached configuration is only available on MP-RASUNIX. It is not supported on Windows or Linux.

2.1.2 BAR FrameworkThe recent and the recommended approach for all platforms is the BARframework. In this architecture, backups and restores are managed by dedicatedBAR Servers that are connected to the Teradata DBS nodes via Gigabit EthernetLAN. This approach off loads the BAR work from Teradata nodes and offers betterscalability. Additionally, this approach supports disk backups and sharing ofdevices. These features are not available in the direct-attached architecture.

Figu re 2-2: An example of

BAR

framework

You can also install multiple Teradata systems at a single site, which can beconfigured within a single or multiple NetVault: Backup Domains. When setting upmultiple NetVault: Backup Domains, ensure that each Teradata system hasaccess to separate backup devices. To understand the different ways to configurethe BAR Servers, consult the Teradata Global Support Center, or the BakBoneSoftware Teradata OEM Group, in San Diego, California, USA.

Node1

Node2

Node3

Node4

Node5

Node6

Node7

Node8

Tape Librar y

BARServer

TeradataMasterPlugin

NetVaultServer

NetVaultClient

NetVaultClient

NetVaultClient

NetVaultClient

Robotic ControlPath

Teradata System

BARServer

TeradataSlavePlugin

BARServer

TeradataSlavePlugin

BARServer

TeradataSlavePlugin

BARServer

TeradataSlavePlugin

541A012

Gbit Switch


15/110


1

Figure 2-3: An example of

two Teradatasystems at a

single site

2.2.0 Prerequisites

Before starting the plugin installation, refer to the following notes and complete therequired tasks:

Install the NetVault: Backup Server software on the designated machine. Thismachine can be a BAR Server or any other machine outside the TeradataDBS system. The Server machine can run any supported operating systemregardless of the DBS operating system.

The NetVault: Backup Server is the core software that provides backupmanagement services and controls all the operations and devices (includingthe logical control of robotics). For instructions on installing the NetVault:Backup Server software, refer to the NetVault: Backup Installation Guide .Select the Teradata Master Plugin node. The NetVault: Backup Serverconfigured as the Teradata Master Plugin is suitable in most cases. However,you can also choose one of the BAR Servers or any other machine on thenetwork to serve as the Teradata Master Plugin node.Install the NetVault: Backup Client software on the BAR Servers and theTeradata Master Plugin node (if this machine is not configured as the

NetVault: Backup Server). For instructions on installing the NetVault: BackupClient software, refer to the NetVault: Backup Installation Guide .Install Teradata Tools and Utilities (TTU) on the Teradata Master Plugin nodeand the BAR Servers. The Teradata Plugin v12.x requires TTU 13.0 or later.For multi-stream backups and restores, set up a Teradata ARC Server (TARAServer). This Server facilitates communication between the ARC processes.

541A0

Robotics

9200NVServer

NVClient

NVClient

NVClient

FibreChannel

Switch

TeradataProductionSystem

(4 nodes)

TeradataDevelopment

System(2 nodes)

Shared Libraryw/Shared

Tape DrivesRobotics9200

BARServer

NVServer

NVClient

NVClient

NVClient

Teradata

ProductionSystem(4 nodes)

TeradataDevelopment

System(2 nodes)

SharedLibrary

BARServer

BARServer

BARServer

BARServer

BARServer

BARServer

BARServer


16/110


16

Install Protegrity Defiance BAR Encryption Module on the BAR Servers onwhich you want to run encrypted backups. The encryption feature is onlysupported on Linux and Windows.

Add NetVault: Backup Clients to the NetVault: Backup Server. For

instructions, refer to the NetVault: Backup Administrator’s Guide . Add the backup devices to the NetVault: Backup Server. For instructions,refer to the NetVault: Backup Administrator’s Guide .

2.3.0 Installing Teradata Plugin

To install the Teradata Plugin, perform the following steps.

Note: In order to upgrade the Teradata Plugin, you must first remove the existingversion of the plugin. For details on removing the plugin, refer to RemovingTeradata Plugin on page 17 .

1. Open the Client Management window on NetVault: Backup Server. (ClickClient Management on the toolbar or Large Buttons panel. Alternatively, onthe Administration menu, click Client Management .)

2. Under Clients , locate the Teradata Master Plugin node/BAR Server.Right-click this node, and select Install Software .

3. In the browse window, navigate to the location of the .npk installation file forTeradata Plugin (on the installation CD or the directory to which the file wasdownloaded from BakBone Software's web site). Depending on the operatingsystem, the file path for this software may vary on the installation CD.

4. Select the file named tera-x-x-x-x.npk (where x-x-x-x represents theplatform and version number), and click Open to begin the plugin installation.Upon completion, a message will be displayed.

2.4.0 Installing the License Key

BakBone recommends that you install the permanent license keys for NetVault:Backup and Teradata Plugin before the 45-day evaluation period expires. Thepermanent license keys can be requested at http://licenses.bakbone.com . Toinstall the permanent license keys for the software, perform the following steps:

1. Open the Client Management window.2. Under Clients , locate the Teradata Master Plugin node/BAR Servers.3. Right-click this node, and select Install License Key to open the License

Key Installation window.


17/110


1

Figure 2-4: License Key

Installationwindow

4. Enter (or copy/paste) the license key in the Enter Key String box.5. Click OK .

2.5.0 Removing Teradata Plugin

To remove the Teradata Plugin, perform the following steps:

1. Open the Client Management window.2. Under Clients , locate the BAR Server on which the Teradata Plugin is

installed. Right-click this node, and select Remove Software .3. In the Remove Software window, select Teradata in the list of plugins and

click Remove .4. In the confirmation dialog, click OK .


18/110


18


19/110


1

Chapter 3:

C ONFIGURING T ERADATAP LUGIN

This chapter describes how to configure the default settings for the TeradataPlugin. The information in this chapter is organized into the following topics:

Configuring the Default SettingsUsing Remote Configurator to Configure the Default SettingsUsing NetVault: Backup Configurator to Configure the Default Settings

Adding Teradata DBS

Reconfiguring the Cluster CountRemoving a DBS

Adding BAR ServersEnabling Communication Between the Teradata Master Plugin and BARServersConfiguring a Default Login AccountCreating or Upgrading the Catalog DatabaseCreating User Accounts for Parallel Restores

Creating Restore AccountsGranting Privileges to the Accounts

Revoking Privileges from the AccountsDefining Encryption Algorithms

3.1.0 Configuring the Default Settings

After installing the plugin, configure the default settings for the plugin. Start withthe Teradata Master Plugin as the plugin cannot be accessed on any other nodeuntil this node is set up. Then, repeat the procedure on each BAR Server on whichthe plugin is installed. You cannot use the plugin for backups and restores until thisprocedure is completed. To configure the default settings for the plugin, performthe following steps:

1. Open the Backup window on the NetVault: Backup Server. (Click Backup the toolbar or Large Buttons panel. Alternatively, on the Operations menuclick Backup .)

2. On the Selections tab, locate the Teradata Master Plugin Node/BAR Server.Double-click this node, or right-click and select Open .


20/110

Chapter 3Configuring Teradata Plugin

20

3. Locate Teradata in the list of plugins. Right-click this node, and selectConfigure .You can also access the Configure window using the methods described inthe following sections:

Using Remote Configurator to Configure the Default SettingsUsing NetVault: Backup Configurator to Configure the Default Settings

4. Configure the following parameters:Figu re 3-1:

Configurewindow for

TeradataPlugin


21/110


2

Node is the Teradata Master Plugin – Select Node is the TeradataMaster Plugin check box on the machine that is serving as the TeradataMaster Plugin node. The Teradata Master Plugin controls the TeradataDBS backups and restores. You can browse the DBS system, and

schedule jobs only from the Teradata Master Plugin node. On the otherBAR Servers, this check box must remain clear.Path to ARCMAIN Utility – Enter the file path for the ARCMAIN utility.Additional ARCMAIN Command Line – Enter the additional run-timeparameters that you want to pass with the ARC jobs. For example,CHECKSUM=1 for data integrity verification during restore, orCHECKSUM=2 for data integrity verification during all backups andrestores.In order to pass multiple parameters, separate them using commas orwhite spaces as delimiter. If a value contains comma or white space,

enclose it within single or double quotes. Refer to the Teradata Archive/ Recovery Utility Reference Guide for more information on run-timeparameters.Path for Teradata Plugin and ARC Working Files – The workingdirectory path must be relative to the NetVault: Backup installationdirectory, regardless of whether NetVault: Backup is installed on thedefault installation directory or a custom directory. By default, the workingdirectory is set to the following relative path:

MP-RAS – teradataLinux – teradata

Windows – TeradataAccess Module Block Size (kilobytes) – This parameter specifies thesize of the data block Teradata sends to NetVault: Backup and is intendedfor use in a future release. Do not change this parameter.Allow Use of Network Attached Devices – Select this option to enableuse of network devices for backups and restores. This setting applies toall backup and restore jobs. You can override the settings on a per-jobbasis via the Backup Options and Restore Options tabs.Use ARC Catalog – To store the backup information in a catalog, selectthe Use ARC Catalog check box. A catalog allows direct tape positioningduring restore and copy operations, resulting in quicker data retrieval. Inaddition to selecting this check box, you must also configure the catalogdatabase name in the ARC Catalog Database box to use catalog forbackups performed using the Teradata Plugin.


22/110


22

ARC Catalog Database – By default, the catalog database is named$NETVAULT_CATALOG , which can be changed to any valid databasename in Teradata. Before you begin using the plugin for backups, youmust create the catalog database. For details, refer to Creating or

Upgrading the Catalog Database on page 31 . If you are running morethan one Teradata DBS, create a catalog with the same name on eachDBS.Number of Restore Accounts for Parallel Restores – For restoringcluster archives in parallel, the Teradata Plugin requires multiple useraccounts to spawn concurrent jobs on the BAR Servers. Teradata ARCdoes not allow concurrent restore operations by the same user.In the Number of Restore Accounts for Parallel Restores box, enterthe total number of user accounts that can be used for parallel restores.The number of restore accounts can be determined by the total number of

drives available to the BAR Servers. In addition to setting this parameter,you must configure the Restore Account Base Name as describedbelow.Restore Account Base Name – The Teradata Plugin requires you tocreate multiple restore accounts with the same base name and a serialnumber appended to it. The default base name for the user accounts isNETVAULT , which can be changed to any valid user name in Teradata.Before initiating a parallel restore operation, make sure that the requirednumber of restore accounts are created on the DBS. For example, if youset the Number of Restore Accounts for Parallel Restores to 2, thenwith the base name NETVAULT you must create two user accounts withthe names NETVAULT1 and NETVAULT2 for parallel restores. If you arerunning more than one Teradata DBS, create these restore accounts oneach DBS. For details on creating restore accounts, refer to Creating User

Accounts for Parallel Restores on page 32 .Send Script to Editor Application – If you intend to edit the plugingenerated ARC script before execution, select Send Script to EditorApplication check box and provide the Editor Application name asdescribed below.Editor Application – This parameter can be configured to edit the scriptin an interactive mode (Windows only) or batch mode (all supported O/S).The edits performed via the Interactive or the Batch Mode apply only tothe current instance of the backup or restore job. The ARC script is notmodified permanently.


23/110


2

Interactive Mode – This feature is only available on Windows. To usethis feature, enable the Allow Service to Interact with Desktopoption for the NetVault Process Manage r service as described below:

From the Services panel, open the Properties window for the

NetVault Process Manager .Select the Allow Service to Interact with Desktop check box onthe Log On tab.

Then, enter the application path for the Text Editor in this box. Makesure that the application is accessible to the Teradata Master Plugin.When a job starts (as determined by the job schedule), the TeradataPlugin will automatically start the editor application and open the scriptfile. After making the changes when you close the editor, the plugin willtransfer the updated script to the BAR Server on which it is to beexecuted, and run the job. The Administrator must be present when

the job is scheduled in order to edit the script. Otherwise, the job willremain in an idle state with an open editor window.Batch Mode – The Batch Mode script editing feature utilizes scriptsthat automatically make the necessary edits to the ARC scripts withoutany manual input. Exercise caution when using the Batch Mode editingfeature and thoroughly test the script before using it as this script willbe executed for every job.To use the batch editing mode, you must do the following:

First, write a script that will automate script editing.Then, enter the file path for the script in the Editor Application box.

When a job starts, the Teradata Plugin passes the generated ARCscript as an argument to the script file, which will modify the ARCscript. When finished, the Teradata Plugin will run the updated script.When entering the script file name in the Editor Application box,consider the following:

On MP-RAS UNIX and Linux platforms, use the following format:

/bin/sh On Windows, use the following format for a batch (.bat) file:

The file path must not contain any spaces.On Windows, use the following format for a PERL script:

perl


24/110


25/110


2

ARCMAIN Backup Connect-Back Timeout (Minutes) – Enter thetimeout interval for the ARC to connect back to Teradata Plugin duringcluster backups. The job will be aborted if the connect-back does not takeplace within the specified interval. The timeout applies to all cluster

backup jobs. The default setting for this parameter is 10 minutes.ARCMAIN Restore Connect-Back Timeout (Minutes) – Enter thetimeout interval for the ARC to connect back to the Teradata Plugin duringcluster restores. The job will be aborted if the connect-back does not takeplace within the specified interval. The timeout applies to all cluster restore

jobs. The default setting for this parameter is 10 minutes.Progress Statistics Update Interval (Seconds) – Enter the refresh ratefor data transfer statistics on the Job Monitor window. By default, thisinformation is updated every 10 seconds. You can set it to any valuebetween 0 and 600 seconds. When set to zero, the plugin refreshes the

Job Monitor window after completing the backup of each table ordatabase object. Setting the refresh interval to a very low value mighthave a negative impact on performance.Change ARC Priority – This parameter is only available on MP-RASUNIX platform. It allows you to set the scheduling priority for the

ARCMAIN and nvdevmgr (NetVault Device Manager) process for betterthroughput. The priority can be set to High or Highest , or reset back toNormal . Note the following:

Setting the priority level to High or Highest does not have anynegative impact on the other processes when the ARCMAINprocesses are not running. The plugin raises the scheduling priorityonly when a job is running.It is also possible to change the setting while a job is in progress.This parameter can be configured only from the Selections tab on theNVBU Backup window. Setting the priority level via the NetVault:Backup Configurator or Remote Configurator will not work.

Restore Media Request (Timeout) – Enter the timeout interval for theavailability of media during restore. The job will be aborted if the backupmedia is not available within the specified interval. When set to zero, the

job waits indefinitely for the media. Therefore, BakBone recommends thatyou change this default value and set an appropriate timeout period to exitgracefully.


26/110


26

Media Availability Check Timeout – By default, the Teradata Plugindoes not check for the availability of suitable drives/media on a BARServer before spawning a backup job. The plugin chooses a BAR Serverdepending on its current load and gives priority to those with no active

jobs. This can result in the selection of a BAR Server that does not haveany online drives or suitable media. Consequently, the job continues towait while the other available resources remain un-utilized.To avoid this problem, set a timeout interval for drive/media availability ona BAR Server. This allows the Teradata Plugin to exclude BAR Servers onwhich required resources are not detected within the specified interval,and choose BAR Servers that have at least one online drive with suitablemedia. The recommended timeout interval is two minutes.The default value for this parameter is zero. Retain the default value if youdo not want to use this feature.

TARA Server Machine Address – This parameter is required to use themulti-stream backup and restore methods that are available with TeradataPlugin v12.0 and later versions. For multi-stream backups and restores,set up a TARA Server, and enter the Server name or IP Address in theTARA Server Machine Address box.

Note: The Full Multi-stream and Full Multi-stream On-line methods cannot beused without configuring the TARA Server name/address.

TARA Server Port – This parameter is set to the default listener port forthe TARA Server, which is 54323. Change the port number if the TARA

Server is configured to listen on a different port in your setup.ARCMAIN Log Line Wrap Width – On TTU 13.0 and later, thisparameter can be used to set a value for the ARCMAIN LINEWRAPparameter. ARCMAIN uses this setting while displaying the log messages.By default, the messages are wrapped at 80 characters. To change theLINEWRAP settings, enter the number of characters at which you want

ARCMAIN to wrap the message. You can specify any value in the range0-255. The line wrap setting works as follows:

0 – No wrapping1-79 – Line wrapped at 80 characters

80-255 – Line wrapped at the specified value> 255 – Line wrapped at 80 characters

5. Click OK to save the settings.


27/110


2

3.1.1 Using Remote Configurator to Configure the DefaultSettingsTo open the Configure window from Remote Configurator, perform the followingsteps:

1. Open the Client Management window on the NetVault: Backup Server.(Click Client Management on the toolbar or Large Buttons panel.

Alternatively, on the Administration menu, click Client Management .)2. Under Clients , locate the Teradata Master Plugin Node/BAR Server.

Right-click this node, and select Configure to start the Remote Configurator.3. On the Remote Configurator, click the Plugin Options tab. Then, click the

Teradata Plugin tab.4. Continue from step 4 of the section Configuring the Default Settings on pag

19 .

3.1.2 Using NetVault: Backup Configurator to Configure theDefault SettingsTo open the Configure window from the NetVault: Backup Configurator, performthe following steps:

1. Open NetVault: Backup Configurator.2. Click the Plugin Options tab.3. Next, click the Teradata Plugin tab.4. Continue from step 4 of the section Configuring the Default Settings on pag

19 .

3.2.0 Adding Teradata DBS

After configuring the default settings, add the target DBS to the Teradata Plugin.The plugin cannot be used for backups and restores until this procedure iscompleted. This procedure must be repeated for each target DBS that is to beprotected using the Teradata Plugin. To add a Teradata DBS, perform the followingsteps:

1. Open the Backup window.

2. On the Selections tab, open the Teradata Master Plugin node (double-clickthe node, or right-click the node, and select Open ).3. Locate Teradata in the list of plugins. Right-click the node, and select Add

DBS .4. In the Enter Name of Teradata RDBMS window, configure the following

parameters:


28/110


28

Figu re 3-2: Enter Name of

TeradataRDBMSwindow

DBS Name – Enter the name of the target DBS. Ensure that this machinehas a corresponding COP1 mapping in the /etc/hosts file of each BARServer. For example, if the Teradata DBS is called TeraDB , then the

/etc/hosts file on each BAR Server must have an alias mapping for theDBS name as TeraDBcop1 .Cluster Count – Enter the total number of clusters contained in the DBS.The cluster count is required to determine the number of parallel jobs forcluster archiving.

5. Click OK . The DBS will be added to the plugin and displayed under theTeradata node.

3.2.1 Reconfiguring the Cluster CountTo reconfigure the DBS cluster count when a cluster is added or removed, performthe following steps:

1. Open the Backup window.2. On the Selections tab, open the Teradata Master Plugin node (double-click

the node, or right-click the node, and select Open ).

3. Locate Teradata in the list of plugins, and open this node.4. Right-click the Teradata DBS node, and select Change Cluster Count .5. Reconfigure the parameters as described below:

DBS Name – The DBS name is displayed in this box. It cannot bechanged.Cluster Count – Update the number of clusters according to the currentDBS settings.

6. Click OK to save the new settings.

3.2.2 Removing a DBSTo remove a Teradata DBS, perform the following steps:


the node, or right-click the node, and select Open ).


29/110


2

3. Locate Teradata in the list of plugins, and open this node.4. Right-click the target DBS node, and select Remove DBS .5. In the confirmation dialog, click Yes .

3.3.0 Adding BAR Servers After adding the Teradata DBS to the plugin, perform the following steps to add theBAR Servers:


the node, or right-click the node, and select Open ).3. Locate Teradata in the list of plugins, and open this node.4. Right-click the Teradata DBS node, and select Define Clients for DBS .

5. Configure the following parameters:Figure 3-3:

Define Clientsfor Teradata

DBS window

Client – The Teradata Plugin will display all the NetVault: Backup Clientslisted under Clients in the NVBU Client Management window. Selectonly the BAR Servers that will participate in the backup and restoreoperations.Number of Drives – Corresponding to the selected BAR Servers, enterthe number of drives available on each. The drive count helps indetermining the number for parallel data streams that can be generatedfor the cluster and multi-stream backups and restores.

6. Click OK .

Note: Follow the same procedure to add or remove BAR Servers, or toreconfigure the drives available to a BAR Server.


30/110


30

3.4.0 Enabling Communication Between theTeradata Master Plugin and BAR Servers

If the Teradata Master Plugin is configured on a NetVault: Backup Client, performthe following steps to enable communication between the Teradata Master Pluginnode and the BAR Servers:

1. Open a terminal session on the Teradata Master Plugin node and navigate tothe .../netvault/util directory (where ... represents the NetVault: Backupinstallation directory).

2. Issue the following command:

nvclientaccess -tdclients 3. For password-protected Clients, enter the NetVault: Backup password when

the prompt appears. The Verified Password for Client

message confirms access to the Client nodes.4. Next, open a terminal session on the BAR Server and navigate to the

.../netvault/util directory (where ... represents the NetVault: Backupinstallation directory).

5. Issue the following command:

nvclientaccess -client

6. When the prompt appears, enter the NetVault: Backup password for themachine. The Verified Password for Client messageconfirms the access to the Teradata Master Plugin node.

7. Perform steps 4–6 on the remaining BAR Servers.

3.5.0 Configuring a Default Login Account

The Teradata Plugin requires a DBS user account that has sufficient privileges toconnect to the Server for backups and restores. Configuring a default loginaccount eliminates the need to enter the authentication details each time aconnection to the Teradata Database is required. The plugin establishes aconnection automatically using the default account. When a default account isconfigured, the existing job definitions are not affected by any changes in the user

account or password. If you do not configure a default account, the job definitionsmust be changed each time the user account or password is changed.

To configure a default login account for the plugin, perform the following steps:


the node, or right-click the node and select Open ).3. Locate Teradata in the list of plugins and open this node.


31/110


3

4. Right-click the Teradata DBS node and select Set Default Logon .5. Configure the following parameters:

Figure 3-4: Set Default

Login window

Default Account – Enter a Teradata DBS user name with sufficientprivileges to run backup and restore jobs.Password – Enter the password associated with the configured user.Use Default Login – Select this option to connect to the database

automatically without waiting for user input.6. Click OK to save the authentication details.

Important: If the password for the configured user is changed in the TeradataDBS, you must also update the default logon details for the Teradata Plugin.

3.6.0 Creating or Upgrading the Catalog Database

A catalog database stores information about backups. It enables direct tapepositioning during restore and copy operations which expedites the process. Usethe procedure described below to create or upgrade a catalog database from theplugin GUI. Before proceeding ensure that you have configured the Use ARCCatalog and ARC Catalog Database options. For details, refer to Configuring theDefault Settings on page 19 . Note the following:

If you have created a catalog using a previous version of the plugin, it isnecessary to upgrade the database to create tables that store the additionalinformation required for this function.The Teradata Plugin includes a Catalog Database Maintenance feature,which can be used to remove unnecessary records related to savesets thathave been retired, blanked or removed from the NVDB. For details onmanaging the catalog database, refer to Managing the Catalog Database opage 57 .

To create or upgrade a catalog database, perform the following steps:


the node, or right-click the node and select Open ).3. Locate Teradata in the list of plugins, and open this node.


32/110


32

4. Right-click the Teradata DBS node, and select Create/Upgrade CatalogDatabase .

5. Configure the following parameters:Figu re 3-5:

CreateCatalog Database

window

Enter Password for DBC Account – Enter the password for the DBCuser account.Catalog Database Name – This box displays the Catalog database namespecified in the Configure window. It should not be changed. Any changemust be made in the Configure window.Permanent Storage Space – By default, 100000000 bytes are allocatedto the permanent storage space. For details on optimum storage space forthe Catalog database, refer to the relevant Teradata Documentation.

6. Click OK to initiate catalog creation.If you have added more than one DBS to the Teradata Plugin, repeat thisprocedure for each added DBS.

3.7.0 Creating User Accounts for Parallel Restores

Teradata ARC does not allow concurrent restore operations by the same user. Asa result, the Teradata Plugin requires multiple user accounts to run parallel jobs forrestoring cluster archives. Note the following:

If the restore accounts are not created, the cluster restore jobs will fail and themessage User Identification is Not Authorized will be logged.If sufficient restore accounts are not created, the job will not fail. However, themessage Parallelism is Lost will be displayed.If necessary privileges are not granted, the restore jobs will fail and themessage User does not have RESTORE Access to Database xxx will be

logged.The procedure for creating restore accounts can be divided into the followingsteps:

Creating Restore AccountsGranting Privileges to the Accounts


33/110


3

These steps are described in the following sections. Before proceeding make surethat you have configured the Number of Restore Accounts for ParallelRestores and the Restore Account Base Name parameters in the Configurewindow. For details, refer to Configuring the Default Settings on page 19 .

Note: You can also use the BTEQ commands to create the restore accounts. Fordetails on using BTEQ, refer to the relevant Teradata Documentation .

3.7.1 Creating Restore AccountsTo create the restore accounts, perform the following steps:


the node, or right-click the node, and select Open ).3. Locate Teradata in the list of plugins, and open this node.4. Right-click the Teradata DBS node, and select Create Restore Accounts5. Configure the following parameters:

Figure 3-6: CreateRestore

Account(s)window

Enter Password for DBC Account – Enter the password for the DBCuser account.Restore Account Base Name – This box displays the base name for therestore account specified in the Configure window. It should not bechanged. Any change must be made in the Configure window.Number of Account to Create – This box displays the number of restoreaccounts specified in the Configure window. It should not be changed.

Any change must be made in the Configure window.Password for New Accounts - Enter a password for the restore

accounts. The same password is set for all restore accounts.6. Click OK to start creating the accounts.

If you have added more than one DBS to the Teradata Plugin, repeat thisprocedure for each added DBS.


34/110


34

3.7.2 Granting Privileges to the AccountsTo grant the necessary privileges to the restore accounts, perform the followingsteps:

Note: You can also use the BTEQ commands to grant user privileges. For detailson using BTEQ, refer to the relevant Teradata Documentation .

1. On the Selections tab, open the Teradata Master Plugin node (double-clickthe node, or right-click the node, and select Open ).

2. Locate Teradata in the list of plugins, and open this node.3. Open the Teradata DBS node.4. Right-click the database node, and select Change Restore Privileges .5. Configure the following parameters:

Figu re 3-7:

ChangeRESTORE

Privilegeswindow

Account Name – Enter the user name with DBC account privileges.Password – Enter the password associated with the configured user.Restore Account Base Name – This box displays the base name for therestore account, and should not be changed.Number of Restore Accounts – This box displays the number of restoreaccounts configured. Do not change this value unless you want to grantpermissions only to specific number of restore accounts.Operation – Click Grant to grant the restore privilege on the database.

6. Click OK to complete the procedure.

3.7.2.a Revoking Privileges from the Accounts

To revoke the privileges, perform the following steps:


2. Locate Teradata in the list of plugins, and open this node.3. Open the Teradata DBS node.4. Right-click the database node, and select Change Restore Privileges .


35/110


3

5. Configure the following parameters:Account Name – Enter the user name with DBC account privileges.Password – Enter the password associated with the configured user.Restore Account Base Name – This box displays the base name for therestore account, and should not be changed.Number of Restore Accounts – This box displays the number of restoreaccounts configured. Do not change this value unless you want to revokepermissions only from specific number of user accounts.Operation – Click Revoke to revoke the granted privileges.

6. Click OK to complete the procedure.

3.8.0 Defining Encryption Algorithms

Using the Protegrity Defiance BAR Encryption solution, the Teradata Plugin allowsyou to encrypt your backups with any of the supported ciphers. This feature is onlysupported on Windows 2003 R2 and Linux. It is not available on MP-RAS UNIX.The Defiance module must be installed on each BAR Server on which you intendto run the encrypted backups. Currently, the Defiance module supports AES128,

AES256, and PANAMA ciphers. To update the cipher list, perform the followingsteps:


2. Locate Teradata in the list of plugins, and open this node.

3. Right-click the Teradata DBS node, and select Define EncryptionAlgorithms .4. Update the cipher list as described below:

Figure 3-8: Define

Encryption Algorithms

window


36/110


36

DBS Name – This box displays the Teradata DBS name.Enter Encryption Algorithms – The default list includes the followingalgorithms - AES128, AES256, and PANAMA. To use any other algorithmprovided by the Defiance module, add it to this list. Do not add any cipher

that is not supported by the Defiance module. Selecting such a cipher fora backup would cause a job to fail.

5. Click OK to save the list.


37/110


3

Chapter 4:

B ACKING UP D ATA WITHT ERADATA P LUGIN

This chapter describes how to use the Teradata Plugin to perform backups. Theinformation in this chapter is organized into the following topics:

Available Backup MethodsFull BackupFull On-line BackupFull Clustered Backup

Full Clustered On-line BackupFull Multi-stream BackupFull Multi-stream On-line BackupIncremental BackupData Dictionary BackupUser-defined Backup Scripts

Performing Full and Full On-line BackupsSelecting Data for a Backup

Choosing the Backup MethodConfiguring the Backup Options

Using Catalog Archiving Only Non-empty DatabasesForcing Lock ReleasesUsing Network-attached DevicesConfiguring the Restart CheckpointsSelecting the Encryption Cipher Setting Query Band

Configuring Number of SessionsOverriding the ARC OptionsEnabling Checksum During Restore

Choosing the BAR Server to Run BackupFinalizing and Submitting a Job

Performing Full Clustered and Full Clustered On-line Backups


38/110

Chapter 4Backing up Data with Teradata Plugin

38

Performing Full Multi-stream and Full Multi-stream On-line Backups Archiving Selected Partitions of PPI Tables

Considerations While Archiving PartitionsProcedure for Backing up PPI PartitionsModifying the PPI Filter ExpressionDe-selecting PPI Partitions

Performing Incremental BackupBacking up Only Data DictionaryResuming a Job From Last CheckpointGenerating ARC Scripts OnlyBacking up Data with User ScriptsManaging the Catalog Database

Performing Catalog Database Maintenance from the Plugin GUIPerforming Catalog Database Maintenance from the CLI

Using Selection SetsCreating a Selection SetLoading a Selection Set

Additional Notes

4.1.0 Available Backup Methods

An archive operation copies the selected data from the Teradata database to oneor more archive files. You can use the Teradata Plugin to backup databases,tables and other database objects, and partitions of PPI tables. The pluginsupports the following backup methods:

All-AMPsCluster Multi-stream

Each method can be used to perform online or offline backups. The onlinebackups allow concurrent updates to tables while the backup is in progress. TheTeradata Plugin utilizes automatic logging for online backups on Teradata

Database 12.0 and later. On prior versions of the database, you must activatepermanent journaling for online backups. Without automatic or permanent logging,read locks are placed on the object being backed up, preventing updates duringthe backup. The available backup types are described in the sections that follow.


39/110


3

4.1.1 Full BackupThe Full Backup method archives data from all AMPs into a single archive file.Read utility locks are used to prevent updates by other users during backup.When a database is selected, the read utility lock is placed at the database levelbefore archiving begins. When individual tables are selected, the lock is placed oneach table before it is archived. The locks are released when the backupcompletes.

4.1.2 Full On-line BackupLike Full Backup, this method archives the database objects from all AMPs into asingle archive file. However, unlike the Full Backup method, the database objectsare accessible for writes during a backup. The updates are logged to permanentor temporary journals. The archive contains the data dictionary, tables and objects,and the change images in the journal which can be rolled forward during a restore.

The implementation of Full On-line Backup differs on Teradata Database V2R6and the later releases:

Teradata Database V2R6 – On V2R6, the Full On-line Backups can only beused to backup databases with permanent journals. You must also enable theAllow ARC Script Journaling parameter. For details, refer to Configuringthe Default Settings on page 19 . Group Read locks are placed during backupto allow concurrent updates.Teradata Database 12.0 and Later – Permanent journals are not required onTeradata database 12.0 and later as the DBS automatically sets up therequired logging mechanism when an on-line backup is requested.

4.1.3 Full Clustered BackupThe Full Clustered Backup archives data from all AMPs into a set of archive filescalled a cluster archive. With cluster archives, multiple data streams can begenerated for a single job which can potentially reduce the overall backup time,especially when targeting large database objects. Read utility locks are used toprevent updates by other users during backup. When a database is selected, theread utility lock is placed at the database level before archiving begins. Whenindividual tables are selected, the lock is placed on each table before it is archived.The locks are released when the backup completes.

The Full Cluster backup consists of two phases:Phase 1 archives the data dictionary.

Phase 2 archives the data tables and objects into cluster archives.


40/110


40

4.1.4 Full Clustered On-line BackupLike Full Clustered Backup, this method archives the data from all AMPs into a setof archive files. Multiple data streams can be generated for the backup job toreduce overall backup time. However, unlike the Full Clustered Backup method,the database objects are accessible for writes during a backup. The updates arelogged to permanent or temporary journals. The archive contains the datadictionary, data tables and objects, and the change images in the journal whichcan be rolled forward during a restore. The implementation of Full ClusteredOn-line Backup differs on Teradata Database V2R6 and the later releases:

Teradata Database V2R6 – On V2R6, the Full Clustered On-line backupscan only be used to backup databases with permanent journals. You mustalso enable the Allow ARC Script Journaling parameter as described inConfiguring the Default Settings on page 19 . Group Read locks are placedduring backup to allow concurrent updates. The backup consists of three

phases:Phase 1 archives the data dictionary.Phase 2 archives the data tables into cluster archives.Phase 3 archives the change images recorded in the permanent journalsduring backup.

Teradata Database 12.0 and Later – Permanent journals are not required onrelease 12.0 and later as the DBS automatically sets up the required loggingmechanism when an on-line backup is requested.

Note: The use of permanent journaling is not supported through the TeradataPlugin GUI if the Teradata Database Version parameter on the Configure window is set to Teradata Database 12.0 or Teradata Database 13.0 and Later .The support for permanent journals through the Teradata Plugin GUI is limited toTeradata V2R6.

4.1.5 Full Multi-stream BackupThe Full Multi-stream Backup method is a new parallel archiving method availablewith TTU 13.0. This method provides enhanced parallelism. With Multi-streammethod, clusters are not considered the smallest unit for generating streams. Thismethod can use much smaller data units (for example, AMPs and sub-AMPs) todistribute data optimally and generate multiple data streams. This enables fasterbackups. The ARCMAIN itself determines how the data is distributed and whatdata each stream backs up. The backup script generated by the plugin does notcontain this information. The data dictionary is automatically included in stream 1.

To use this method, you must set up a TARA Server and specify the server name/IP and port number on the Configure window. The Full Multi-stream backupmethod is not supported on MP-RAS UNIX platform.


41/110


4

Read utility locks are used to prevent updates by other users during a backup.When a database is selected, the read utility lock is placed at the database levelbefore archiving begins. When individual tables are selected, the lock is placed oneach table before it is archived. The locks are released when the backup

completes.

4.1.6 Full Multi-stream On-line BackupThe Full Multi-stream On-line Backup method is similar to the Full Multi-streambackup method, and enables data distribution a granular level. However, thedatabase objects are accessible for writes during a backup. The updates arelogged to permanent or temporary journals. The archive contains the datadictionary, data tables and the change images in the journal which can be rolledforward during restore. The implementation of Full Multi-stream On-line Backupdiffers on Teradata Database V2R6 and the later releases:

Teradata Database V2R6 – On V2R6, the Full Multi-stream On-line backupscan only be used to backup databases with permanent journals. You mustalso enable the Allow ARC Script Journaling parameter as described inConfiguring the Default Settings on page 19 . Group Read locks are placedduring backup to allow concurrent updates.Teradata Database 12.0 – Permanent journals are not required on release12.0 and later as the DBS automatically sets up the required loggingmechanism when an on-line backup is requested.

To use this method, you must set up a TARA Server and specify the server name/IP and port number on the Configure window. The Full Multi-stream On-line

backup method is not supported on MP-RAS UNIX platform.

4.1.7 Incremental BackupFor very large databases, backing up the full database each time may not bepractical. To solve this problem, the Teradata Plugin provides the IncrementalBackup method, which can be used in conjunction with the Full On-line backups toarchive the after-change journals. In the unfortunate event of failure, the fullbackup along with the journal backup can be used to restore and recover thedatabase.

To use the incremental backup method you must activate permanent journaling

and enable the Allow ARC Script Journaling parameter. For details, refer toConfiguring the Default Settings on page 19 .


42/110


42

4.1.8 Data Dictionary Backup A dictionary archive of a database includes the definitions for all the tables, views,macros and triggers, and dictionary entries for the stored procedures. You can usethis option to backup the dictionary information whenever the structure of tables ina cluster is modified.

4.1.9 User-defined Backup ScriptsThe Teradata Plugin also supports backups through user-defined scripts. Fordetails on running your own backup script from the plugin GUI, refer to Backing upData with User Scripts on page 57 .

4.2.0 Performing Full and Full On-line Backups

The procedure for performing Full and Full On-line backups can be divided into the

following steps:Selecting Data for a BackupChoosing the Backup MethodConfiguring the Backup OptionsChoosing the BAR Server to Run BackupFinalizing and Submitting a Job

These steps are described in detail in the following sections.

4.2.1 Selecting Data for a Backup

To select the data for a backup, perform the following steps:1. Open the Backup window on the NetVault: Backup Server. (Click Backup on

the toolbar or Large Buttons panel. Alternatively, on the Operations menu,click Backup .)

2. On the Selections tab, open the Teradata Master Plugin node. To open anynode on the Selections tab, you can do either of the following:

Double-click the nodeRight-click the node, and then select Open

3. Locate Teradata in the list of plugins, and open this node.

4. Open the Teradata DBS node to display the Hierarchical View andClassical View nodes. These are the two methods the Teradata Pluginprovides to browse the DBS and select the database objects.


43/110


4

Figure 4-1:

Selections tabon Backup

window.On Teradata

database 13.0 and later, the

databaseobjects, such

as triggers,views, stored

proceduresand others are

also listed inthe selection

tree

Hierarchical View – This view displays the parent-child structure of theDBS. It is similar to the DBS view in the Teradata Administrator

application.Classical View – This view displays a flat selection tree, ignoring theparent-child relationship.

5. Select the desired browse method, and open the DBS node to view thecontents.

6. A login prompt will appear if you have not configured a default login accountfor the plugin. Configure the following parameter in the login window:

Account Name – Enter a Teradata DBS user name. This user accountmust have sufficient privileges to run backup and restore jobs.Password – Enter the password associated with the configured user.

Click OK . Upon authentication, the database structure will be displayed.This step is not applicable if you have configured a default login account forthe plugin. For details, refer to Configuring a Default Login Account on page30 .


44/110


44

7. Make the data selections as described below:Select an Entire DBS – In the Hierarchical View, the entire DBS can beselected for a backup by selecting the DBC node. In the Classical View,each node must be selected manually.

Select DBC System Tables – The DBC system tables can only beselected when performing a Full or a Full Multi-stream backup. This canbe done by selecting the node in the HierarchicalView, or the DBC node in the Classical View.Select Individual Database(s)Select (Individual) Tables and Other Types of Database Objects – OnTeradata database 13.0 and later you can also select database objects,like triggers, views, stored procedures and others.Select PPI Table Partitions – The ability to select partitions of a PPI tableis limited to Full and Full Multi-stream backup methods. The other backupmethods do not support backups of PPI table partitions. For moreinformation, refer to Archiving Selected Partitions of PPI Tables on page52 .Select Include ALL Option – In the Classical View, right-click a databasenode, and select Include ALL to select all the tables and its descendants.Include ALL will mark the selected database with a red arrow in additionto the standard green check in the checkbox and add the label ALL to thedatabase name. It is important to know the structure of the databasebefore using this option or this may result in data being backed up twice.To remove Include ALL , right-click and select Cancel Include ALL .

Note the following:For excluding the child objects after selecting a parent node, firstcomplete all the selections and then omit the unwanted objects frombackup. An inclusion after exclusion will result in a failed job.The All, Default and Public objects are not displayed in the HierarchicalView. Select the DBC node to backup these objects.The SYSUDTLIB which contains the definition of all User Defined Types(UDTs) is logically linked to the DBC. When you archive DBC, theSYSUDTLIB is automatically included. If you exclude DBC, theSYSUDTLIB is also excluded.


45/110


4

4.2.2 Choosing the Backup MethodClick the Backup Options tab, and select one of the following backup methods:

Full – Select this method to perform an all AMPs backup of the selected data

without any journaling.Full On-line – To use this backup method with V2R6, you must activatepermanent journaling and enable the Allow ARC Script Journaling parameter. For details, refer to Configuring the Default Settings on page 19

4.2.3 Configuring the Backup OptionsConfigure the remaining Backup Options as described in the following sections.

Figure 4-2: Backup

Options for Full and Full

On-linemethods

4.2.3.a Using Catalog

To store the backup information in the catalog, do the following:

Select the Use ARC Catalog check box in the Configure window. Fordetails, refer to Configuring the Default Settings on page 19 .Create the required catalog database. For details, refer to and Creating orUpgrading the Catalog Database on page 31 .Under Backup Type , leave the Use ARC Catalog check box selected.

Clear this check box if you do not want to use the catalog for a particular job, forexample, when archiving the Catalog database itself.


46/110


46

4.2.3.b Archiving Only Non-empty Databases

Under Backup Type , select the Archive only NONEMPTY DATABASES checkbox to exclude any empty users or databases.

4.2.3.c Forcing Lock ReleasesTo enforce lock releases when a job is aborted, select the Force Release Lock onAbort check box. The lock is not guaranteed to release in all cases. Particularly,the following events will result in a leftover lock:

If ARC is forcibly aborted by the user or operating system. If communication to the Teradata Database is lost and cannot bereestablished.If an internal failure occurs in ARC, such that program control cannot proceedto, or complete, the release lock step.

4.2.3.d Using Network-attached Devices

By default, the Teradata Plugin writes only to locally available devices. To usenetwork-attached devices, select the Allow Use of Network Attached Devices check box under Backup Type . To apply this setting globally to all jobs, select thischeck box in the Configure window.

4.2.3.e Configuring the Restart Checkpoints

The CHECKPOINT parameter saves restart information in the Restart Log at thespecified intervals. This allows you to resume a failed job from the last checkpointbefore failure. To write the restart information to the log, configure the followingparameters:

Enable Checkpoint Restarts – Select the Enable CheckpointRestarts check box to save the tape positioning and other processinginformation in the restart log.Checkpoint Frequency – Enter the checkpoint frequency in terms of numberof blocks processed. During backup, the markers are placed at the specifiedinterval or at the end of an object, whichever occurs first. Since checkpointoperations cause I/O and additional processing overhead, too manycheckpoints might adversely impact performance.

4.2.3.f Selecting the Encryption Cipher To encrypt the backup data, select the cipher in the Encryption Algorithm listunder Advanced Options . By default, this list includes AES128 , AES256 , andPANAMA . To use other ciphers supported by Defiance, add them to the cipher list.For details, refer to Defining Encryption Algorithms on page 35 . For no dataencoding leave the default NONE selected.


47/110


4

This feature is only supported on Windows 2003 R2 and Linux platforms. It is notavailable on MP-RAS UNIX operating system. The Defiance module must beinstalled on each BAR Server on which you want to run the encrypted backups.

4.2.3.g Setting Query Band

A query band is a set of name and value pairs that can be set on a session toidentify where a query originated. Query bands offer a way to identify the user andapplication, for example, when applications use pooling mechanisms that hide theidentity of users because each connection in the pool logs into the database usingthe same user account. Without query bands, there is no way to tell the source ofthe request when the request comes from a multi-tiered application. Anotherpotential use of query bands is troubleshooting, when it is necessary to providethe specific user or application that issued a request.

To set the query band, enter the band identifier string for the Query Band ID

parameter under Advanced Options . This string must be specified in thefollowing format ‘name1=value1;name2=value2;’ . You can specify a maximum of2048 characters in the string.

4.2.3.h Configuring Number of Sessions

In the Sessions box under ARCmain Options , enter the maximum number ofTeradata Database sessions available for the archive and recovery operations.The default value for this parameter is 4. Teradata ARC uses two control sessionsfor archive and recovery operations. The additional sessions are required forparallel processing during backups and restore/copy operations.

The optimal number of sessions is site specific and depends on the database sizeand other factors. Consult a Teradata representative if you are unsure of howmany sessions to use. For most sites 16 sessions is a good starting point. Anyconnected sessions that are not actually used in the operation result in wastedsystem resources.

4.2.3.i Overriding the ARC Options

To override any of the globally configured ARC parameters or to specify additionalrun-time parameters for the given job, enter the parameters and their values in theOverride ARC Options box under ARCmain Options . Enter the correct syntaxwhile configuring this parameter. The Teradata Plugin will not check for anysyntactical errors when you save or submit the job.

Note: This option will be passed as the last argument to ARCMAIN so that the youcan override any ARC parameter, including the ones generated internally by theplugin.


48/110


48

4.2.3.j Enabling Checksum During Restore

To validate data integrity during restore, select the Enable ARC Checksums check box under Overrides .

Alternatively, you can enter CHECKSUM=2 in the Override ARC Options box tovalidate data integrity during both backups and restores. To apply this settingglobally to all jobs, configure CHECKSUM as an Additional ARCMAINCommand Line parameter in the Configure window.

4.2.4 Choosing the BAR Server to Run BackupFor All-AMPs backups, you do not have to specify the target BAR Server whiledefining the job. By selecting in the Run Job on Client list underOverrides , you can direct the plugin to automatically find the most suitable targetand spawn the job on that BAR Server at run-time. The suitability of a BAR Serveris based on the following two criteria, ensuring that the job does not have to waitfor drive or media availability during execution:

The BAR Server has least number of concurrent active jobsIt has access to an online drive

To override the auto-selection and run the job on particular BAR Server, select thetarget machine in the Run Job on Client list.

4.2.5 Finalizing and Submitting a JobTo finalize and submit the backup job, perform the following steps:

1. Click the Schedule , Target and Advanced Options tabs, and configure therequired options. These options are common to all NetVault: Backup plugins.For more information on configuring these options, refer to the NetVault:Backup Administrator’s Guide .

Note: For the Teradata Plugin, you cannot configure the Local Drives Only optionon the Target tab.

2. Enter a title for the job in the Job Title box at the top right corner of theBackup window. Specify a detailed title that allows you to easily identify the

job for monitoring its progress or restoring data.3. Click Submit on the toolbar. Alternatively, on the Accept menu, click Submit

Backup . To monitor the job progress and access logs, refer to Viewing Logsand Job Progress on page 87 .


49/110


4

4.3.0 Performing Full Clustered and Full ClusteredOn-line Backups

To generate a cluster backup, perform the following steps:

1. Select the data for backup. For details, refer to Selecting Data for a Backupon page 42 .

2. Click the Backup Options tab, and select one of the following backupmethods:

Figure 4-3: Backup

Options for Full Clustered

and Full Clustered On-

line methods

Full Clustered – Select this method to perform a cluster backup of theselected data without any journaling.Full Clustered On-line – To use this method with V2R6, you mustactivate permanent journaling and select the Allow ARC ScriptJournaling parameter as described in Configuring the Default Settings page 19 .

3. Configure the appropriate backup options. For details, refer to Configuringthe Backup Options on page 45 .

4. To run parallel cluster backup jobs, configure the following parameters underMPP Options :


50/110


50

Maximum Parallel Data Streams to Use – Enter the maximum numberof parallel streams that can be generated for the cluster backup. This willdepend on the total number of drives accessible to the BAR Servers onwhich the sub-jobs will run.

Cluster Batch Size – Enter the number of clusters to be backed up byeach sub-job. The number of sub-jobs is equal to Cluster Count divided byBatch Size.Retry Failed Clusters on Another Remaining Client – Select this checkbox to retry the backup job on remaining BAR Servers if a job failsbecause of any of the following reasons:

Write Error – The backup fails on a BAR server as a result of writeerror caused by a bad tape or a bad tape drive (Access Module errorcode ARC0805; severity 12).ARCMain Dies Unexpectedly – The ARCMain process is aborted ordies unexpectedly on a BAR server.NetVault Processes Die Unexpectedly – The NetVault: Backupprocesses are aborted or die unexpectedly on a BAR server.

The Teradata Plugin will attempt to restart the failed cluster sub-jobs onthe remaining active BAR Servers. This might increase the backup timedepending on (1) how much data was transferred before the error, and (2)whether an idle BAR Server is available immediately. The job status is setto Backup Completed with Warnings if any of the sub-jobs has to berescheduled while the other sub-others are successful.If you do not select this check box, the job will be aborted when a sub-jobfails.

5. Complete and submit the job. For details, refer to Finalizing and Submitting aJob on page 48 .

4.4.0 Performing Full Multi-stream and Full Multi-stream On-line Backups

With TTU 13.0, you can use the Full Multi-stream and Full Multi-stream On-linebackup methods instead of the clustered backup methods for better performance.To use these backup methods, you must set up a TARA Server and configure the

server address/IP and port number in the Configure window. For details, refer toConfiguring the Default Settings on page 19 . With these methods, you just need tospecify the total number of data streams. The generation of streams anddistribution of data is managed by the ARCMAIN.

Note: The Full Multi-stream and Full Multi-stream On-line backup methods are notsupported on MP-RAS UNIX.


51/110


5

To generate multi-stream backups, perform the following steps:

1. Select the data for backup. For details, refer to Selecting Data for a Backupon page 42 .

2. Click the Backup Options tab, and select one of the following backupmethods:

Figure 4-4: Backup

Options for Full Multi-

stream and Full Multi-

stream On-linemethods

Full Multi-stream – Select this method to perform multi-stream archivingwithout any journaling.Full Multi-stream On-line – To use this method with V2R6, you mustactivate permanent journaling and select the Allow ARC ScriptJournaling parameter as described in Configuring the Default Settings page 19 .

3. Configure the appropriate backup options. For details, refer to Configuringthe Backup Options on page 45 .

4. To run parallel jobs, configure the following parameter under MPP OptionsMaximum Parallel Data Streams to Use – Enter the maximum numberof parallel streams that can be generated for the backup job. This willdepend on the total number of drives accessible to the BAR Servers onwhich the sub-jobs will run.

5. Complete and submit the job. For details, refer to Finalizing and Submitting aJob on page 48 .


52/110


52

4.5.0 Archiving Selected Partitions of PPI Tables

With Teradata Plugin, you can archive the individual partitions of a PPI tableinstead of performing a full table backup. This feature can be used for the

following: Archive only a subset of data and avoid duplication. This can minimize thesize of the archive and i

NetVault Backup Teradata Plugin Users Guide English

Documents

Transcript of NetVault Backup Teradata Plugin Users Guide English