Dell EMC Avamar Release 7.5.1 NDMP Accelerator for Oracle ZFS

Dell EMC Avamar NDMP Accelerator for
Oracle ZFS
Version 7.5.1
User Guide
302-004-288
REV 01
Copyright © 2001-2017 Dell Inc. or its subsidiaries. All rights reserved.
Published September 2017
Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED
IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.
Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.
Published in the USA.
Dell EMC
Hopkinton, Massachusetts 01748-9103
1-508-435-1000 In North America 1-866-464-7381
www.DellEMC.com
2
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
CONTENTS
Figures
5
Tables
7
Preface
9
Chapter 1
Introduction
13
Architecture................................................................................................ 14
How Avamar works with NAS systems........................................... 14
Protecting multiple NAS systems with one accelerator.................. 14
Multiple data streams.....................................................................14
Data Domain system support......................................................... 15
Avamar Installation Manager.......................................................... 15
Backup........................................................................................................ 15
Backup methods............................................................................ 15
Filer dump modes........................................................................... 15
Restore....................................................................................................... 16
Restore types.................................................................................16
Restore destinations...................................................................... 16
Restored metadata.........................................................................16
Chapter 2
Installation and Configuration
17
Preparing the system.................................................................................. 18
Checking the system requirements................................................ 18
Verifying network connectivity.......................................................18
Configuring NDMP service settings............................................................ 19
Installation and configuration of the accelerator software..........................20
Installation and configuration with the Avamar Installation Manager
...................................................................................................... 20
Installation and configuration by using the legacy command line
method.......................................................................................... 22
Changing accelerator settings.................................................................... 25
Enabling or disabling multiple simultaneous backups .....................26
Combining accounts (optional)......................................................26
Upgrading the accelerator software........................................................... 27
Upgrading by using the Avamar Installation Manager.....................27
Upgrading by using the legacy command line method....................29
Uninstalling the accelerator software......................................................... 30
Configuring NTP time services....................................................................31
Configuring the accelerator for dual NIC operation (optional).................... 32
Chapter 3
Backup
35
Limitations..................................................................................................36
Performing on-demand backups.................................................................36
Scheduling backups....................................................................................38
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
3
CONTENTS
Creating a dataset......................................................................... 38
Creating a group............................................................................39
Enabling scheduled backups.......................................................... 40
Monitoring backups.....................................................................................41
Canceling backups...................................................................................... 41
Best practices for ZFS backups ................................................................. 41
Chapter 4
Restore
43
Limitations..................................................................................................44
Creating an Oracle ZFS filesystem for non-UTF-8 restores........................44
Restoring to the original NAS system ........................................................ 45
Restoring to a Linux or Windows client.......................................................46
Monitoring restores.................................................................................... 48
Canceling restores......................................................................................48
Chapter 5
Best Practices
49
Appendix A
Plug-in Options
51
How to set plug-in options..........................................................................52
Backup options...........................................................................................52
Restore options.......................................................................................... 53
Appendix B
Command Line Interface
55
avndmp...................................................................................................... 56
Specifying command line options................................................................ 61
Script processing........................................................................................ 61
Appendix C
Troubleshooting
65
Log files......................................................................................................66
Restore problems and solutions..................................................................66
Glossary
4
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
67
FIGURES
1
2
Accelerator deployment diagram.................................................................................14
Networking diagram.................................................................................................... 18
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
5
FIGURES
6
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
TABLES
1
2
3
4
Typographical conventions..........................................................................................10
Backup plug-in options............................................................................................... 52
Restore plug-in options.............................................................................................. 53
Script clauses for the --run-at-start-clauses and --run-at-end-clauses options......... 62
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
7
TABLES
8
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
PREFACE
As part of an effort to improve the product lines, revisions of the software and
hardware are periodically released. Therefore, some functions that are described in
this document might not be supported by all versions of the software or hardware
currently in use. The product release notes provide the most up-to-date information
on product features.
Contact the technical support professional when a product does not function correctly
or does not function as described in this document.
Note
This document was accurate at publication time. To find the latest version of this
document, go to Online Support (https://support.EMC.com).
Purpose
This publication describes how to install, configure, administer, and use the Avamar
NDMP Accelerator to back up and restore supported Oracle ZFS storage appliances.
Audience
The information in this publication is primarily intended for system administrators who
are responsible for installing software and maintaining servers and clients on a
network.
Persons using this publication should have current practical experience with:
l
Network data management protocol (NDMP)
l
Supported network attached storage (NAS) systems currently deployed at the
site
l
UNIX shell commands
Revision history
The following table presents the revision history of this document.
Revision
Date
Description
01
February 1, 2018
GA release of Avamar 7.5.1
Related documentation
The following publications provide additional information:
l
Avamar Compatibility and Interoperability Matrix
l
Avamar Release Notes
l
Avamar Administration Guide
l
Avamar Data Store Gen 4 Multi-Node System Installation Guide
l
Avamar Operational Best Practices Guide
l
Avamar Product Security Guide
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
9
PREFACE
Special notice conventions used in this document
These conventions are used for special notices.
DANGER
Indicates a hazardous situation which, if not avoided, results in death or serious
injury.
WARNING
Indicates a hazardous situation which, if not avoided, could result in death or
serious injury.
CAUTION
Indicates a hazardous situation which, if not avoided, could result in minor or
moderate injury.
NOTICE
Addresses practices that are not related to personal injury.
Note
Presents information that is important, but not hazard-related.
Typographical conventions
These type style conventions are used in this document.
Table 1 Typographical conventions
10
Bold
Used for names of interface elements, such as names of windows,
dialog boxes, buttons, fields, tab names, key names, and menu paths
(what the user specifically selects or clicks)
Italic
Used for full titles of publications that are referenced in text
Monospace
Used for:
l
System code
l
System output, such as an error message or script
l
Pathnames, filenames, prompts, and syntax
l
Commands and options
Monospace italic
Used for variables
Monospace bold
Used for user input
[]
Square brackets enclose optional values
|
Vertical bar indicates alternate selections - the bar means “or”
{}
Braces enclose content that the user must specify, such as x or y or
z
...
Ellipses indicate nonessential information that is omitted from the
example
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
PREFACE
Where to get help
The Avamar support page provides access to licensing information, product
documentation, advisories, and downloads, as well as how-to and troubleshooting
information. This information may resolve a product issue before contacting Customer
Support.
To access the Avamar support page:
1. Go to https://support.EMC.com/products.
2. Type a product name in the Find a Product by Name box.
3. Select the product from the list that appears.
4. Click the arrow next to the Find a Product by Name box.
5. (Optional) Add the product to the My Products list by clicking Add to My Saved
Products in the upper right corner of the Support by Product page.
Documentation
The Avamar product documentation provides a comprehensive set of feature
overview, operational task, and technical reference information. To supplement the
information in product administration and user guides, review the following
documents:
l
Release notes provide an overview of new features and known limitations for a
release.
l
Technical notes provide technical details about specific product features, including
step-by-step tasks, where necessary.
l
White papers provide an in-depth technical perspective of a product or products
as applied to critical business issues or requirements.
Knowledgebase
The Knowledgebase contains applicable solutions that you can search for either by
solution number (for example, esgxxxxxx) or by keyword.
To search the Knowledgebase:
1. Click Search at the top of the page.
2. Type either the solution number or keywords in the search box.
3. (Optional) Limit the search to specific products by typing a product name in the
Scope by product box and then selecting the product from the list that appears.
4. Select Knowledgebase from the Scope by resource list.
5. (Optional) Specify advanced options by clicking Advanced options and specifying
values in the available fields.
6. Click Search.
Online communities
Go to Community Network at http://community.EMC.com for peer contacts,
conversations, and content on product support and solutions. Interactively engage
online with customers, partners, and certified professionals for all products.
Live chat
To engage Customer Support by using live interactive chat, click Join Live Chat on
the Service Center panel of the Avamar support page.
Service Requests
For in-depth help from Customer Support, submit a service request by clicking Create
Service Requests on the Service Center panel of the Avamar support page.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
11
PREFACE
Note
To open a service request, you must have a valid support agreement. Contact a sales
representative for details about obtaining a valid support agreement or with questions
about an account.
To review an open service request, click the Service Center link on the Service
Center panel, and then click View and manage service requests.
Enhancing support
It is recommended to enable ConnectEMC and Email Home on all Avamar systems:
l
ConnectEMC automatically generates service requests for high priority events.
l
Email Home sends configuration, capacity, and general system information to
Customer Support.
Comments and suggestions
Comments and suggestions help to continue to improve the accuracy, organization,
and overall quality of the user publications. Send comments and suggestions about
this document to DPAD.Doc.Feedback@emc.com.
Please include the following information:
12
l
Product name and version
l
Document name, part number, and revision (for example, 01)
l
Page numbers
l
Other details to help address documentation issues
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
CHAPTER 1
Introduction
This chapter includes the following topics:
l
l
l
Architecture....................................................................................................... 14
Backup............................................................................................................... 15
Restore...............................................................................................................16
Introduction
13
Introduction
Architecture
The following topic explains the Avamar system architecture for using the network
data management protocol (NDMP) to protect data residing on network attached
storage (NAS) systems.
How Avamar works with NAS systems
In order to back up and restore data residing on NAS systems, Avamar uses a device
called an Avamar NDMP Accelerator (accelerator).
The accelerator is a dedicated Avamar server node that functions as an Avamar client.
The accelerator uses NDMP to interface with and access NDMP-based NAS systems.
Figure 1 Accelerator deployment diagram
Data from the NAS system is not stored on the accelerator. The accelerator performs
NDMP processing and real-time data deduplication, and then sends the data directly
to the Avamar server.
You can connect the accelerator to either a Local Area Network (LAN) or Wide Area
Network (WAN) with respect to the Avamar server. However, to ensure acceptable
performance, the accelerator must be located on the same LAN as the NAS systems.
Protecting multiple NAS systems with one accelerator
A single accelerator can support more than one NAS system. However, you cannot
perform more than one backup at a time.
For example, consider two NAS systems: NAS-1 and NAS-2. Both NAS systems use
the same accelerator and both systems belong to the same backup group.
When scheduled group backups are initiated, NAS-1 begins backing up immediately,
while NAS-2’s backup job is queued until NAS-1’s job completes.
Multiple data streams
All NDMP plug-ins have a Maximum Concurrent Data Streams setting, which
controls the maximum number of simultaneous NDMP data streams that can be
allocated to each NAS system backup or restore operation.
In order to implement NDMP multi-streaming, multiple simultaneous backups must be
enabled on the accelerator, and each backup and restore operation must comprise
multiple targets so that each target can be allocated to a separate NDMP data stream.
14
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Introduction
Multi-streaming is automatically enabled when either root ("/") or an empty string is
specified as the backup target. This causes Avamar to automatically include any
volumes returned by the NDMP volume browse command. Because an NDMP
volume browse is performed before each backup operation, new volumes are
automatically detected and backed up, eliminating the need to manually update
backup datasets when new volumes are instanced on the NAS system.
Data Domain system support
You can store backups on either the Avamar server or a Data Domain® system.
Backup metadata is stored on the Avamar server.
Before you can store backups on a Data Domain system, add the Data Domain system
to the Avamar configuration by using Avamar Administrator. Then select the Data
Domain system in the plug-in options when you perform an on-demand backup or
when you create a dataset for a scheduled backup. You can also use the command line
interface (CLI) to perform backups to a Data Domain system.
The steps to restore backups are the same whether you restore from the Avamar
server or a Data Domain system. The restore process determines the location of the
backup and restores the backup.
Beginning with Avamar 7.4, Data Domain Cloud Tier is also supported. DD Cloud Tier
moves data from Data Domain to the cloud. From the Avamar Administrator, you can
configure cloud tiering to move Avamar backups from Data Domain to the cloud, and
perform seamless recovery of these backups.
The Avamar and Data Domain System Integration Guide provides more information about
Data Domain systems in an Avamar environment, including detailed steps to add a
Data Domain system to the Avamar configuration.
Avamar Installation Manager
With Avamar 7.4, the Avamar Installation Manager is installed on the Accelerator node.
The Avamar Installation Manager is used to manage installation of the Avamar
Accelerator node software and to perform upgrades of the Accelerator node software.
You can also use the command line to install and upgrade the software.
Backup
This topic provides a conceptual overview of NDMP backups.
Backup methods
You can perform both on-demand and scheduled NAS system backups with the
accelerator:
l
Use Avamar Administrator or the Avamar Management Console Command Line
Interface (MCCLI) to perform both on-demand and scheduled backups.
l
Use the avndmp command line interface to perform on-demand backups.
Filer dump modes
Filer dump modes control whether a full or incremental backup is performed.
The first time each NAS system is backed up, Avamar performs a full (level 0) backup.
For subsequent backups, you specify one of the following filer dump modes:
Data Domain system support
15
Introduction
l
Prefer Incremental, but do a Full if required—this mode allows Avamar to
decide whether to perform a full (level 0) or incremental (level 1) backup each
time a backup is performed. Most backups will be incrementals. However, this
mode allows Avamar to detect certain conditions that should necessitate a full
backup to ensure data compatibility.
l
Force a level 0 dump—this mode causes Avamar to reprocess the entire NAS
system. However, Avamar data deduplication will optimize the backup on the
accelerator so that only new data is sent to the server. Although this requires
additional processing time, the actual data sent to the Avamar server is the same
as for an incremental (level 1) backup.
l
Force an incremental (level 1) dump—this mode causes Avamar to perform an
incremental (level 1) backup, even if certain conditions exist that should
necessitate a full (level 0) backup.
Although full backups do take longer than incrementals because the NAS system
sends all its data to the accelerator, Avamar's client-side deduplication only sends data
to the Avamar server that has not previously been backed up.
Restore
This topic provides a conceptual overview of NDMP restore.
Restore types
When restoring from an NDMP backup, you can restore the entire backup, or selected
folders and files.
Restore destinations
Restore destinations can be the original NAS system, or any Linux or Windows client
registered with the Avamar server.
If NDMP data is restored to an Avamar Linux or Windows client, it can be easily
accessed and shared by establishing an NFS mount on Linux systems, or a CIFS mount
on Windows systems.
Note
Applications that rely on file metadata such as alternate streams may not be able to
correctly open files restored from a NAS backup to an NFS or CIFS mount. Restore
such files back to the NAS device, either to the original location or to an alternate
location.
Restored metadata
When restoring to a NAS system, all native accounting information and Access Control
Lists (ACLs) are restored.
When restoring to an Linux or Windows filesystem, metadata such as ACLs, alternate
data streams, attributes associated with hard links or file compression, is not restored.
16
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
CHAPTER 2
Installation and Configuration
This chapter includes the following topics:
l
l
l
l
l
l
l
l
Preparing the system..........................................................................................18
Configuring NDMP service settings....................................................................19
Installation and configuration of the accelerator software................................. 20
Changing accelerator settings............................................................................25
Upgrading the accelerator software................................................................... 27
Uninstalling the accelerator software.................................................................30
Configuring NTP time services........................................................................... 31
Configuring the accelerator for dual NIC operation (optional)............................32
Installation and Configuration
17
Installation and Configuration
Preparing the system
These tasks prepare the system for accelerator software installation and
configuration.
Checking the system requirements
Ensure that the environment meets the client compatibility requirements before you
install Avamar accelerator software.
Updated, detailed NAS system compatibility information is available in the Avamar
Compatibility and Interoperability Matrix at http://compatibilityguide.emc.com:8080/
CompGuideApp.
Verifying network connectivity
This task verifies that the Avamar server, accelerator, and NAS systems are
connected to the network and can communicate with one another.
Before you begin
1. Connect the Avamar server, accelerator, and NAS systems to the network using
100BaseT or 1000BaseT network connections, as shown in the following figure:
Figure 2 Networking diagram
You can connect the accelerator to either a LAN or WAN with respect to the
Avamar server. However, to ensure acceptable performance, the accelerator must
be located on the same LAN as the NAS systems.
2. Add each hostname to corporate DNS, or modify /etc/hosts files on each
network host such that:
l
The Avamar server and accelerator can resolve each other’s hostnames.
l
The accelerator and NAS systems can resolve each other’s hostnames.
Note
The Avamar server and NAS systems do not need to directly resolve each other’s
hostnames.
3. Ensure that the Avamar server, accelerator, and NAS systems are powered on.
Procedure
1. Open a command shell and log in to the Avamar server as admin.
2. Type ping accelerator, where accelerator is the accelerator hostname as
defined in corporate DNS.
18
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
The accelerator responds to the ping command.
3. Open a command shell and log in to the accelerator as admin.
4. Type ping avamar-server, where avamar-server is the Avamar server
hostname as defined in corporate DNS.
The Avamar server responds to the ping command.
5. Type ping NAS-system, where NAS-system is the NAS system hostname as
defined in corporate DNS.
Type one ping NAS-system command for each NAS system you have
connected to this accelerator.
All NAS systems respond to the ping command.
Configuring NDMP service settings
Configure NDMP service settings on the Oracle ZFS storage appliance.
Procedure
1. Open a web browser and type the following URL:
https://oracle-zfs:215
where oracle-zfs is the Oracle ZFS storage appliance network hostname or IP
address.
The login web page appears.
2. Type the superuser (root) Username and Password, and then click LOGIN.
The dashboard web page appears.
3. On the dashboard web page, click Configuration > Services.
A list of services appears.
4. In the Data Services list, click NDMP.
The NDMP service configuration page appears.
5. Configure the following settings:
a. Clear the Ignore metadata-only changes checkbox.
b. Add one or more Target restore pools.
c. Set the Allow token-based backup checkbox.
d. In the ZFS rollback before restore list, select On DMA request.
e. Leave the Allow direct access recovery checkbox set.
Note
Direct access recovery is not supported by Avamar. Either setting is
permissible.
f. Clear the Restore absolute paths checkbox.
g. Set the DMA tape mode to BSD.
h. Type ndmp in the DMA username (MD5 auth) field.
Configuring NDMP service settings
19
Installation and Configuration
i. Type a password for ndmp user account in the DMA password (MD5 auth)
field.
j. Click Apply.
6. Ensure the NDMP service is enabled by verifying that the NDMP service
indicator is green.
Installation and configuration of the accelerator software
For the Avamar accelerator version 7.4 and later, there are two methods for
performing installation and configuration of the accelerator software.
l
Using the Avamar Installation Manager. Installation and configuration with the
Avamar Installation Manager on page 20 provides instructions.
l
Using the legacy command line method. Installation and configuration by using the
legacy command line method on page 22 provides instructions.
Installation and configuration with the Avamar Installation Manager
This section provides procedures for installation and configuration of the Avamar
NDMP accelerator software with the Avamar Installation Manager.
Downloading and installing the Avamar Installation Manager software for the accelerator node
In this procedure, you download the Avamar Installation Manager software to be
installed on the accelerator node, which will then be used to install and configure the
accelerator software.
Procedure
1. Download the Avamar Installation Manager install package:
a. In a web browser, go to https://support.emc.com/.
b. In the search field, enter the appropriate Avamar release (for example,
Avamar 7.4).
c. In the left pane of the search results, click DOWNLOADS.
d. Click Avamar.
e. Locate and download the Avamar version SLES 11 Bundle installation
package, where version is the version of the Avamar software (for example,
Avamar 7.4 SLES11 Bundle).
Download the install package to /usr/local/avamar/src/ on the
accelerator node.
2. Open a command shell and log in to the accelerator as admin.
3. Switch user to root by typing su -, and then pressing Enter.
4. Install the Avamar Installation Manager:
a. Change to the /usr/local/avamar/src/ by typing:
cd /usr/local/avamar/src
b. Unzip the bundle:
unzip AvamarBundle_SLES11_64-version.zip
where version is the version of the Avamar software.
20
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
c. Run the following command to install the Avamar Installation Manager:
sh ./AvamarBundle_SLES11_64/avinstaller-bootstrapversion.sles11_64.x86_64.run
where version is the version of the Avamar software.
Downloading the Avamar accelerator software
Download the accelerator software installation package, then upload it to the Avamar
server's package repository for installation by using the Avamar Installation Manager.
Procedure
1. In a web browser, go to https://support.emc.com/.
2. In the search field, enter the appropriate Avamar release (for example, Avamar
7.4).
3. In the left pane of the search results, click DOWNLOADS.
4. Click Avamar.
5. Locate and download the AcceleratorInstallSles-version.avp
accelerator software installation package, where version is the version of the
Avamar software.
Download the package to a temporary location such as /tmp.
Installing the Avamar accelerator software
This procedure describes how to launch the Avamar Installation Manager on the
accelerator node and install the accelerator software.
Procedure
1. Open a web browser and log in to Avamar Installation Manager:
a. Type the following URL:
https://Accelerator-node:7543/avi
where Accelerator-node is the IP address or resolvable hostname of the
Avamar accelerator node.
The Avamar Installation Manager login page appears.
2. Type root for the username in the User Name field and changeme for the
password in the Password field.
Note
The Avamar Product Security Guide contains instructions for changing the
default password.
3. Upload the accelerator installation package to the software repository:
a. Click Repository.
The Repository tab appears.
b. Click Browse to browse to the location where the accelerator installation
package was downloaded in Downloading the Avamar accelerator software
on page 21 and select the package.
Installation and configuration with the Avamar Installation Manager
21
Installation and Configuration
Once the package upload completes, it automatically appears in the
Repository table.
4. Click the SW Releases tab.
The Software Releases page opens.
5. Click Install.
The Installation Setup page appears.
6. Complete the information on the Installation Setup page and click the NAS
Settings tab.
The Require NAS system configuration option is selected by default. If you do
not wish to configure NAS systems at this point, unselect the option and click
Continue.
7. If the Require NAS system configuration option is selected, you must add at
least one NAS system:
a. Click Add NAS system.
b. Select the NAS system type.
c. Enter the resolvable Hostname or IP address of the NAS system.
d. Enter the NDMP account name and password.
e. Select the encoding schema to be used for the password.
f. For the Avamar account field, enter the Avamar client name created for this
system.
The client name must be lower case.
g. The Accelerator hostname/IP field defaults to the local host's hostname or
IP address, but can be changed if necessary.
h. Click Continue.
Note
To delete a NAS system configuration prior to clicking Continue, click the red X
to the left of the configuration that you wish to delete.
After clicking Continue, the accelerator software is installed.
Installation and configuration by using the legacy command line method
This section provides procedures for installation and configuration of the Avamar
NDMP accelerator software when by using the legacy command line method.
Downloading the Avamar software
Connect to the Avamar server and download the accelerator software installation
packages.
Before you begin
Prior to installing the Avamar client software, you must first download the
UpgradeClientDownloads package from the repository to the Avamar server. After
downloading the file, you must install it on the server for the client installation
packages to be available. Follow instructions for downloading and installing new
packages from the repository in the Avamar Administration Guide to download and
install the client installation packages to the server.
22
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
Procedure
1. Open a web browser and type the following URL:
https://Avamarserver/dtlt/home.html
where Avamarserver is the Avamar server network hostname or IP address.
The Avamar Web Restore web page appears.
2. Click Downloads.
3. Click + next to the NDMP Accelerator folder.
4. Click + next to the folder for the appropriate version of the NDMP Accelerator.
5. Download both the AvamarClient-linux-rhel4-x86_64-version.rpm
and AvamarNDMP-linux-rhel4-x86_64-version.rpm install packages to
a temporary install folder such as /tmp.
Installing the Avamar Client for Linux software
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter.
3. Change directory to the temporary install folder. For example, cd /tmp.
4. Install the software by typing:
rpm -ivh AvamarClient-linux-rhel4-x86_64-version.rpm
5. Wait for the installation to complete.
The installation is complete when avagent.d Info: Client Agent
started. appears in the command shell.
Installing the Avamar accelerator software
Before you begin
Ensure that the Avamar Client for Linux software is installed on the accelerator.
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter.
3. Change directory to the temporary install folder. For example, cd /tmp.
4. Install the software by typing:
rpm -ivh AvamarNDMP-linux-rhel4-x86_64-version.rpm
5. Wait for the installation to complete.
The installation is complete when the following appears in the command shell:
You may run /usr/local/avamar/bin/avsetupndmp to register
and activate this NDMP Accelerator Node with the
Administrator server.
Installation and configuration by using the legacy command line method
23
Installation and Configuration
Configuring the accelerator
This task configures various accelerator settings. Perform this task when you add a
new accelerator to the system, or when you change settings for an existing
accelerator.
Before you begin
Ensure that the Avamar Client for Linux and accelerator software is installed on the
accelerator.
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter.
3. Run the accelerator configuration utility by typing avsetupndmp --zfs.
4. Press Enter to accept the default action to stop all running agents.
5. Type the accelerator DNS name or IP address, and then press Enter.
6. Type the Avamar server DNS name or IP address, and then press Enter.
7. Type the Avamar server software root password, and then press Enter.
Note
This is the Avamar server software root password (also known as the GSAN
root password), not the operating system root password.
8. Enable or disable multiple simultaneous backups:
l
To enable multiple simultaneous backups, type y, and then press Enter.
l
To disable multiple simultaneous backups, type n, and then press Enter.
9. From the Configure individual system parameters menu, type 1, and then
press Enter.
10. Type the NAS system DNS name or IP address, and then press Enter.
11. Type the NAS system NDMP user account name, and then press Enter.
12. Type the NAS system NDMP user account password, and then press Enter.
13. Re-type the NAS system NDMP user account password, and then press Enter.
14. Specify which password encoding scheme used by the NAS system:
l
If the encoding scheme is plain text, type text, and then press Enter.
l
If the encoding scheme is other than plain text, type md5, and then press
Enter.
15. Type a short descriptive Avamar account name for this NAS system, and then
press Enter.
This is how that NAS system client instance will appear in Avamar
Administrator. Any user-defined name is acceptable. However, this name must
be unique. When adding a second instance of the same NAS system, ensure
that you differentiate it from any existing Avamar account name.
16. Type the accelerator DNS name or IP address, and then press Enter.
This is an accelerator DNS name or IP address that is resolvable by the NAS
system.
24
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
17. From the Configure individual system parameters menu, continue or exit:
l
To add another NAS system or an additional Avamar client instance of an
existing NAS system, type 1, and then press Enter, and then follow the onscreen instructions.
l
Press Enter to exit this accelerator configuration utility session.
Registering the accelerator
This task registers NAS system client instances on the accelerator with the Avamar
server.
Before you begin
Ensure that the Avamar Client for Linux and accelerator software is installed on the
accelerator, and that the accelerator is configured.
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -.
3. Run the client registration utility by typing avregister.
Note
The avregister command script attempts to register all unregistered client
instances it detects on the accelerator.
4. Type the Avamar server DNS name or IP address, and then press Enter.
5. Specify an Avamar server domain for this client instance:
l
Press Enter to accept the default domain (clients).
l
Type a valid Avamar server domain path, and then press Enter.
When typing a domain path (for example, clients/linux), do not include a
slash (/) as the first character.
Changing accelerator settings
This task describes how to use the avsetupndmp utility to change existing
accelerator settings.
The avsetupndmp utility can be rerun as often as necessary to reconfigure
accelerator settings.
Previously configured NAS system client instances can be edited or removed by
choosing the respective option in the avsetupndmp menu.
To use the accelerator with a different Avamar server, you must also rerun
avregister.
You must always rerun avregister after adding a new NAS system client instance.
Changing accelerator settings
25
Installation and Configuration
Enabling or disabling multiple simultaneous backups
Each accelerator can be configured to process backup requests consecutively
(serially) or simultaneously (in parallel). This setting is applies to all NAS system client
instances.
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter.
3. Run the accelerator configuration utility by typing avsetupndmp --zfs.
4. Press Enter to accept the default action to stop all running agents.
5. Type the accelerator DNS name or IP address, and then press Enter.
6. Type the Avamar server DNS name or IP address, and then press Enter.
7. Type the Avamar server software root password, and then press Enter.
Note
This is the Avamar server software root password (also known as the GSAN
root password), not the operating system root password.
8. Enable or disable multiple simultaneous backups:
l
To enable multiple simultaneous backups, type y, and then press Enter.
l
To disable multiple simultaneous backups, type n, and then press Enter.
9. From the main menu, press Enter to exit this accelerator configuration utility
session.
Combining accounts (optional)
When the multiple simultaneous backups feature is enabled, and multiple accounts are
used to back up multiple volumes on the same NAS system, the accelerator can
become overloaded, causing backups to fail. If this occurs, combine the multiple
accounts into a single account so that the accelerator can allow the maximum number
of concurrent backups supported by that accelerator configuration without
overloading.
Note
You can only combine accounts within the same Avamar domain.
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter.
3. Run the accelerator configuration utility by typing avsetupndmp --zfs.
4. Press Enter to accept the default action to stop all running agents.
5. Type the accelerator DNS name or IP address, and then press Enter.
6. Type the Avamar server DNS name or IP address, and then press Enter.
7. Type the Avamar server software root password, and then press Enter.
26
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
Note
This is the Avamar server software root password (also known as the GSAN
root password), not the operating system root password.
8. Enable multiple simultaneous backups by typing y, and then pressing Enter.
9. From the Configure individual system parameters menu, type 4, and then
press Enter.
10. Type the name of the domain that contains the accounts to be combined.
11. Select the first account to combine by typing the number of the account and
pressing Enter.
12. Select the second account to combine by typing the number of the account and
pressing Enter.
13. From the main menu, continue or exit:
l
To combine additional accounts, type 4, press Enter, and then follow the onscreen instructions.
l
Press Enter to exit this accelerator configuration utility session.
Upgrading the accelerator software
There are two methods for performing upgrades of the accelerator software.
l
Using the Avamar Installation Manager. Upgrading by using the Avamar Installation
Manager on page 27 contains instructions.
l
Using the legacy command line method. Upgrading by using the legacy command
line method on page 29 contains instructions.
Upgrading by using the Avamar Installation Manager
The following procedures are used to upgrade the accelerator software by using the
Avamar Installation Manager.
Procedure
1. Install the Avamar Installation Manager on the accelerator if it has not been
installed, following the procedure at Downloading and installing the Avamar
Installation Manager software for the accelerator node on page 20.
2. Open a web browser and log in to Avamar Installation Manager:
a. Type the following URL:
https://Accelerator-node:7543/avi
where Accelerator-node is the IP address or resolvable hostname of the
Avamar accelerator node.
The Avamar Installation Manager login page appears.
3. Type root for the username in the User Name field and changeme for the
password in the Password field.
Upgrading the accelerator software
27
Installation and Configuration
Note
The Avamar Product Security Guide contains instructions for changing the
default password.
4. Depending on whether the Avamar Downloader Service is being used, do one of
the following:
Note
The Avamar Administration Guide contains information about configuring and
using the Avamar Downloader Service.
l
If the Avamar Downloader Service is being used:
a. Click Configuration.
The Configuration windows appears.
b. Click Check for New Packages.
The Check for New Packages dialog box appears and provides status
messages while the Avamar Downloader Service downloads the manifest
file from the repository server to the local repository on the accelerator
node.
A check mark next to a status message indicates that the process was
successful. An X next to a status message indicates that the process
failed.
c. Click Close on the Check for New Packages dialog box.
d. Click the SW Upgrade tab.
The SW Upgrades page opens.
e. Click Download for the accelerator software to download the software
package listed on the SW Upgrades page.
After a package has successfully downloaded, the Install button will
appear.
l
If the Avamar Downloader Service is not being used:
a. Follow instructions for downloading the accelerator upgrade package at
Downloading the Avamar accelerator software on page 21.
b. Upload the accelerator upgrade package to the software repository:
a. Click Repository.
The Repository tab appears.
b. Click Browse to browse to the location where the accelerator
upgrade package was downloaded in step 4.a on page 28 and select
the package.
Once the package upload completes, it automatically appears in the
Repository table.
c. Click the SW Releases tab.
The Software Releases page opens.
5. Click Install.
The Installation Setup page appears.
28
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
Upgrading by using the legacy command line method
To upgrade the accelerator using the command line, you must upgrade both the
Avamar Client for Linux and Avamar NDMP software packages to the same version.
Downloading the Avamar software
Connect to the Avamar server and download the accelerator software installation
packages.
Before you begin
Prior to installing the Avamar client software, you must first download the
UpgradeClientDownloads package from the repository to the Avamar server. After
downloading the file, you must install it on the server for the client installation
packages to be available. Follow instructions for downloading and installing new
packages from the repository in the Avamar Administration Guide to download and
install the client installation packages to the server.
Procedure
1. Open a web browser and type the following URL:
https://Avamarserver/dtlt/home.html
where Avamarserver is the Avamar server network hostname or IP address.
The Avamar Web Restore web page appears.
2. Click Downloads.
3. Click + next to the NDMP Accelerator folder.
4. Click + next to the folder for the appropriate version of the NDMP Accelerator.
5. Download both the AvamarClient-linux-rhel4-x86_64-version.rpm
and AvamarNDMP-linux-rhel4-x86_64-version.rpm install packages to
a temporary install folder such as /tmp.
Upgrading the accelerator software
Upgrading the accelerator using Linux software upgrade command (rpm -U)
command preserves the existing configuration settings. You do not have to rerun
avsetupndmp or avregister.
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter.
3. Upgrade the Linux client software by typing:
rpm -U AvamarClient*
4. Upgrade the accelerator software by typing:
rpm -U AvamarNDMP-linux-rhel4-x86_64-version*
Running a newer accelerator with a older Avamar server
If you upgrade accelerator software to a newer version, but do not also upgrade the
Avamar server software to the same version, you must upgrade the client plugin
catalog on the Avamar server, then download and install the dpnavclient file on the
Upgrading by using the legacy command line method
29
Installation and Configuration
Avamar server. Downloading the dpnavclient package requires that you open a
Service Request with Customer Service.
Procedure
1. Follow instructions for downloading and installing new packages from the
repository in the Avamar Administration Guide to download and install the
upgrade-client-plugin-catalog to the server.
2. Download and install the dpnavclient installation package:
Note
Please open a Service Request with Customer Service to complete this step.
a. Download the dpnavclient installation package from Customer Service to
a temporary folder on the Avamar server, such as /tmp.
b. Open a command shell and log in to the server as admin.
c. Switch user to root by typing su -, and then pressing Enter.
d. Change directory to the temporary folder where the installation package was
downloaded and upgrade the software by typing:
rmp -Uvh dpnavclient-version.sles11_64.x86_64.rpm
3. Upgrade the accelerator as described in Upgrading by using the legacy
command line method on page 29.
Uninstalling the accelerator software
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter.
3. Query the RPM database for the currently installed Avamar software by typing:
rpm -qa | grep Avamar
4. Note the Avamar accelerator and Linux client software package names.
5. Uninstall the Avamar accelerator software by typing:
rpm -e AvamarNDMP-version
where version is the Avamar NDMP accelerator version.
6. Uninstall the Avamar Linux client software by typing:
rpm -e AvamarClient-version
where version is the Avamar client software version.
30
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
Configuring NTP time services
To avoid any unexpected behaviors, you should keep the time on all nodes in the
system consistent. This procedure configures NTP time services for accelerators
running the SUSE Linux Enterprise Server (SLES) operating system.
Before you begin
Before running this procedure, determine if NTP time services are configured and
functioning on Avamar utility node. If not, do not use this procdure and instead,
manually set the accelerator time to be consistent to Avamar server utility node by
typing yast, selecting System, then Date and Time as described in step 8 on page
31.
Note
Do not perform this task on any accelerator running the Red Hat Enterprise Linux
(RHEL) operating system.
Procedure
1. Open a command shell and log in to the accelerator as admin.
2. Switch user to root by typing su -, and then pressing Enter. Enter the
password if prompted.
3. Copy the /etc/ntp.conf file from the Avamar server utility node by typing:
cp -p /etc/ntp.conf{,.orig}
scp root@utility-node:/etc/ntp.conf /etc/
where utility-node is the DNS name or IP address of the Avamar utility node.
4. Restart the ntpd service by typing:
service ntp restart
5. Verify that the ntpd service started correctly by typing:
service ntp status
Wait 7 to 10 minutes for the system to fully settle.
6. Verify that the ntpd service is synchronizing time by typing:
/usr/sbin/ntpq -pn
Verify that the values in the reach column eventually become nonzero and that
an asterisk appears in the left column of one of the time servers. Ideally, all
reach values are 377, which is an octal value meaning that the last eight time
server contacts were all successful with no misses.
If any reach values are zero, please verify that the list of time servers is correct
in /etc/ntp.conf.
7. Ensure that ntpd service will start at the next reboot by typing:
chkconfig ntp on
8. If you have not already done so, set the local time zone on the accelerator:
a. Type yast, selecting System, then Date and Time.
Configuring NTP time services
31
Installation and Configuration
b. Select the correct local time zone.
For best results, set accelerator local time zone to that of the NAS system
so that both NAS and accelerator log files correlate.
c. Verify that the output of the date command is accurate by typing date.
Configuring the accelerator for dual NIC operation
(optional)
This task configures the accelerator to use two Network Interface Cards (NICs) in
order to maximize data throughput in certain configurations, such as backing up
multiple data streams to a Data Domain system.
Before you begin
Ensure that the Avamar Client for Linux and accelerator software is installed on the
accelerator, and that the accelerator is configured and registered with the Avamar
server.
To maximize data throughput, segregate the NAS system network traffic from the
Avamar server network traffic. Do this by configuring a second NIC such that one NIC
accepts NAS system traffic, and the other NIC connects to the Avamar server.
NAS systems can be on the same or different subnets, and are not required to be on
the same subnet as the Avamar server.
Procedure
1. Obtain and record the following information:
l
IP address for the secondary NIC
l
Subnet mask for the accelerator
l
Hostname for the secondary NIC
l
Gateway IP address of the subnet where the accelerator resides
l
IP address of the NAS system
2. Open a command shell and log in to the accelerator as admin.
3. Switch user to root by typing su -, and then pressing Enter.
4. Run the YaST2 configuration utility by typing yast2, and then pressing Enter.
5. On the YaST2 Control Center main screen, select Network Devices >
Network Settings, and then press Enter.
Note
Use Tab or cursor keys to select menus, submenus, and fields.
6. On the Network Settings screen, highlight the secondary NIC list entry, and
then press F4 to edit secondary NIC settings.
7. On the Network Card Setup screen, highlight Statically assigned IP address,
and then press Enter.
Complete the following:
l
32
In the IP Address field, type the IP address for the secondary NIC.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Installation and Configuration
l
In the Subnet Mask field, type the subnet mask for the accelerator.
l
In the Hostname field, replace the default hostname with the correct
hostname of the secondary NIC.
l
Note and record the device name in the Configuration Name field.
Typically, the device name is eth1.
8. Highlight Next, and then press Enter.
9. On the Network Settings screen, highlight Routing, and then press Enter.
10. In the Default Gateway field, ensure that the Default Gateway setting is
correct. If not, type the correct gateway IP address of the subnet where the
accelerator resides.
11. Highlight Add, and then press Enter.
Complete the following:
l
In the Destination field, type the NAS system IP address.
l
In the Device field, type the device name previously noted on the Network
Card Setup screen.
Typically, the device name is eth1.
l
In the Gateway field, type the IP address of the secondary NIC.
l
In the Netmask field, type the subnet mask for this route.
Typically, the subnet mask will be 255.255.255.255 when a single NAS
system is backing up to an accelerator. However, when multiple NAS
systems are backing up to the same accelerator, the subnet mask might be
different.
12. Exit the YaST2 configuration utility:
l
On the Network Settings screen, highlight OK, and then press Enter.
l
On the YaST2 Control Center main screen, highlight Quit, and then press
Enter.
Configuring the accelerator for dual NIC operation (optional)
33
Installation and Configuration
34
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
CHAPTER 3
Backup
This chapter includes the following topics:
l
l
l
l
l
l
Limitations......................................................................................................... 36
Performing on-demand backups........................................................................ 36
Scheduling backups........................................................................................... 38
Monitoring backups............................................................................................ 41
Canceling backups.............................................................................................. 41
Best practices for ZFS backups ......................................................................... 41
Backup
35
Backup
Limitations
These are the known limitations of Avamar NDMP backup.
Wild cards
You cannot use wild card characters to specify a backup target (that is, which
volumes or folders to include in the backup). This is an NDMP limitation.
Maximum path length
When backing up any Oracle ZFS storage appliance, paths cannot be longer than 1023
characters. This limitation also applies to NFS mounts included in the backup.
Multiple datasets for the same NAS system
When using multiple datasets to back up the same NAS system (for example, using
one dataset for full backups and another for incrementals), the exclude lists must be
identical.
When full and incremental exclude lists differ, the actual system behavior differs
according to the type of incremental backup specified in the dataset:
l
If the dataset specifies Prefer incremental, but do a Full if required, a full
backup runs.
l
If the dataset specifies Force an incremental (level 1) dump, the backup fails.
Avamar Administrator limitations
These are the known limitations of Avamar Administrator to browse and display
information about NDMP backups. None of these limitations affect data integrity or
the ability to restore data from NDMP backups.
l
International characters—When browsing NDMP backups, folder and file names
containing international characters might not display correctly.
l
Folder bytes reported—Folder sizes are often shown to be slightly smaller than
the aggregate size of the folder contents.
l
File size variance—The size of a backup from a NAS system differs from the size
of the on-disk data. For example, the reported size of a backup is the size on the
deduplicated Avamar server disk, not the actual file size.
l
Small backup bytes reported—The number of bytes shown for small NDMP
backups might be a slightly larger than the actual size. This behavior is normal
because the NAS system adds a small amount of data to each backup.
l
User and group names—When listing the contents of a backup, user and group
names appear as numbers instead of plain text names.
l
Browsing folders and files—When browsing an Oracle ZFS file system to create a
dataset or perform an on-demand backup, only volumes are visible. You cannot
browse into volumes to view individual folders or files.
l
Empty folders—When backing up empty folders, Avamar reports a size of
between one and a few kilobytes for each empty folder. The number of kilobytes
reported depends on the number of empty files.
Performing on-demand backups
Procedure
1. In Avamar Administrator, click the Backup & Restore launcher link.
The Backup, Restore and Manage window appears.
36
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Backup
2. Click the Backup tab.
3. Select the accelerator in the top-left tree pane.
4. Select a NAS system client instance in the bottom-left pane.
5. In the Browse for Files, Folders, or Directories pane, select the ZFS via
NDMP plug-in.
6. Select one or more volume checkboxes.
7. Select Actions > Backup Now.
The On Demand Backup Options dialog box appears.
8. Select the backup retention setting:
l
To automatically delete this backup from the Avamar server after a specific
amount of time, select Retention period. Specify the number of days,
weeks, months, or years for the retention period.
l
To automatically delete this backup from the Avamar server on a specific
calendar date, select End date and browse to that date on the calendar.
l
To keep this backup for as long as this client remains active in the Avamar
server, select No end date.
9. From the Avamar encryption method list, select the encryption method to use
for data transfer between the client and the Avamar server during the backup.
The encryption technology and bit strength for a client/server connection
depends on several factors, including the client operating system and Avamar
server version. The Avamar Product Security Guide provides additional
information.
10. (Optional) Set plug-in options:
These settings are all optional. In most cases, system default settings are the
optimum settings for on-demand NDMP backups.
a. Click More Options.
The Backup Command Line Options dialog box appears.
b. Select the Show Advanced Options checkbox.
c. From the Maximum Concurrent Data Streams list, select the maximum
number of data streams that can be utilized concurrently during the backup.
d. From the Filer Dump Mode list, select the type of backup to perform.
Forcing a full (level 0) dump resends all data in the requested volume from
the NAS system to the accelerator. This is not recommended.
For best results, always perform incremental backups at the volume level. Do
not force incremental backups of lower level folders and subfolders because
this can cause backup errors.
e. In the Backup label field, specify a descriptive label for the backup.
f. To run a script before the backup operation starts, type a script file name in
the Run user-defined script at start of backup field. The script must
reside in the accelerator /usr/local/avamar/etc/scripts directory.
g. To run a script after the backup operation ends, type a script file name in the
Run user-defined script at end of backup field. The script must reside in
the accelerator /usr/local/avamar/etc/scripts directory.
Performing on-demand backups
37
Backup
h. To manually enter other plug-in options as free text, click More, type the
plug-in option name and value in the Enter Attribute and Enter Attribute
Value fields, respectively, and then click + (Add to list).
i. Click OK.
The Backup Command Line Options dialog box closes.
11. Click OK.
The On Demand Backup Options dialog box closes and the following status
message appears: Backup initiated.
12. Click OK.
Scheduling backups
Perform these tasks to schedule regular recurring backups of NAS systems.
Creating a dataset
A dataset defines the data included in each scheduled backup, and settings that
control plug-in behavior during the backup.
Procedure
1. In Avamar Administrator, select Tools > Manage Datasets.
The Manage All Datasets window appears.
2. Click New.
The New Dataset dialog box appears.
3. In the Name field, type a name for the dataset.
The name can include alphanumeric characters (A-Z, a-z, 0-9), period (.),
hyphen (-), and underscore (_). Do not use Unicode characters or the following
special characters: ` ~ ! @ # $ % ^ & * ( ) = + [ ] { } | \ / ; : ' " < > , ?
4. (Optional) Limit the dataset to specific volumes:
a. Select Select Files and/or Folders.
b. Click ... (Browse for files and/or folders).
c. In the Select Files and/or Folders dialog box, select a client from the
Clients tree.
d. Expand the plug-in node in the middle pane to view a list of volumes on the
client.
e. If the Browse Command Line Options dialog box appears, enter a password
and click OK.
f. Select the checkbox next to one or more volumes.
These volumes will be included in this dataset.
g. Click OK.
5. (Optional) Specify directories, folders, or files you want to exclude in the
Exclusions tab.
6. Disregard Inclusions tab settings. Inclusions cannot be specified for any NAS
systems.
38
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Backup
7. (Optional) Set plug-in options in the Options tab:
These settings are all optional. In most cases, system default settings are the
optimum settings for scheduled NDMP backups.
a. Select the Show Advanced Options checkbox.
b. From the Maximum Concurrent Data Streams list, select the maximum
number of data streams that can be utilized concurrently during the backup.
c. From the Filer Dump Mode list, select the type of backup to perform.
Forcing a full (level 0) dump resends all data in the requested volume from
the NAS system to the accelerator. This is not recommended.
For best results, always perform incremental backups at the volume level. Do
not force incremental backups of lower level folders and subfolders because
this can cause backup errors.
d. To run a script before the backup operation starts, type a script file name in
the Run user-defined script at start of backup field. The script must
reside in the accelerator /usr/local/avamar/etc/scripts directory.
e. To run a script after the backup operation ends, type a script file name in the
Run user-defined script at end of backup field. The script must reside in
the accelerator /usr/local/avamar/etc/scripts directory.
f. To manually enter other plug-in options as free text, click More, type to
plug-in option name and value in the Enter Attribute and Enter Attribute
Value fields, respectively, and then click + (Add to list).
8. Click OK to close the New Dataset dialog box.
Creating a group
A group is a collection of Avamar clients that use the same policies to implement
scheduled backups. Member clients must all be in the same Avamar domain. When you
create a group, you define the dataset, schedule, and retention policy that apply for
scheduled backups of the group. These settings comprise the group policy, which
controls backup behavior for all members of the group unless you override these
settings at the client level.
Procedure
1. In Avamar Administrator, click the Policylauncher link.
The Policy window appears.
2. Click the Policy Management tab.
3. Click the Groups tab.
4. In the tree pane, select a domain location for this group.
This domain is where the new group object will be stored. It is generally best to
store groups at the Avamar server (root) domain.
5. Select Actions > Group > New > Backup Group.
The New Group wizard appears.
6. In the Name field, type a name for the group.
Creating a group
39
Backup
The name can include alphanumeric characters (A-Z, a-z, 0-9), period (.),
hyphen (-), and underscore (_). Do not use Unicode characters or the following
special characters: ` ~ ! @ # $ % ^ & * ( ) = + [ ] { } | \ / ; : ' " < > , ?
7. Clear the Disabled checkbox to use this group for scheduled client backups.
Selecting the checkbox disables backups for the group.
8. From the Avamar encryption method list, select an encryption method to use
for data transfer between the Avamar server and the client during the backup.
The encryption technology and bit strength for a client/server connection
depends on several factors, including the client operating system and Avamar
server version. The Avamar Product Security Guide provides additional
information.
9. (Optional) Select Override Schedule to override the assigned schedule for this
group:
l
To skip the next scheduled backup, select Skip Next Backup.
l
To perform the next scheduled backup one time only, select Run Next
Backup Once.
10. Click Next, and then select a dataset from the Select An Existing Dataset list.
11. Click Next, and then select a schedule from the Select An Existing Schedule
list.
12. Click Next, and then select a retention policy from the Select An Existing
Retention Policy list.
13. Click Next, and then select one or more clients to be members of this group:
a. Select a domain in the Choose Domain pane.
A list of clients appears in the Choose Clients pane.
b. (Optional) Select the Show sub-domain clients checkbox to see more
clients.
c. Click the checkbox next to one or more clients to include them in this group.
d. To remove a client from the group, select the client from in Members list,
and then click the red X.
14. Save and exit:
a. Click Finish to close the New Group wizard.
b. Click OK to close the Policy window.
Enabling scheduled backups
Scheduled backups occur only for enabled groups. Groups are disabled by default
unless you deselect the Disabled checkbox on the first page of the New Group
wizard. If you did not enable the group when you created it, perform the following
steps to enable scheduled backups to occur.
Before you begin
Ensure that you have created a group containing the NAS systems you want to back
up.
Procedure
1. In Avamar Administrator, click the Policylauncher link.
The Policy window appears.
40
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Backup
2. Click the Policy Management tab.
3. Click the Groups tab.
4. In the tree pane, select the domain where the group resides.
5. Locate the group in the right pane.
6. If Disabled is Yes, then select Actions > Group > Disable Group to enable it.
Disabled changes to No.
Monitoring backups
You can monitor backups to ensure that they are completed successfully and
troubleshoot issues. The Activity Monitor in Avamar Administrator enables you to view
status information for both on-demand and scheduled backups.
Procedure
1. In Avamar Administrator, click the Activity launcher link.
The Activity window appears.
2. Click the Activity Monitor tab.
A list of all activities appears.
3. To filter the results to display only backup activity, select Actions > Filter.
The Filter Activity dialog box appears.
4. Select All Backups from the Type list.
5. Click OK.
Canceling backups
You can cancel a backup any time before it completes. The cancellation might take 5
minutes or longer. The backup may complete before the cancellation finishes.
Procedure
1. In Avamar Administrator, click the Activity launcher link.
The Activity window appears.
2. Click the Activity Monitor tab.
A list of all activities appears.
3. Select the backup from the list.
4. Select Actions > Cancel Activity.
A confirmation message appears.
5. Click Yes.
Best practices for ZFS backups
The following information provides best practices for ZFS backups.
l
Do not include hard links across directories that were backed up separately.
Monitoring backups
41
Backup
The backup of a file, which has hard links across multiple directories, includes
multiple copies of the file. When you restore this backup, you restore multiple
copies of the same file. The restore does not handle hard links across backups.
42
l
Do not backup data paths that are greater than 1023 bytes or the backups will fail.
This is a limitation of Oracle ZFS.
l
Do not create alternate data stream files greater than 2 GB, this could cause the
backup to fail.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
CHAPTER 4
Restore
This chapter includes the following topics:
l
l
l
l
l
l
Limitations......................................................................................................... 44
Creating an Oracle ZFS filesystem for non-UTF-8 restores............................... 44
Restoring to the original NAS system ................................................................45
Restoring to a Linux or Windows client.............................................................. 46
Monitoring restores............................................................................................48
Canceling restores............................................................................................. 48
Restore
43
Restore
Limitations
These are the known limitations of Avamar NDMP restore.
Non-NDMP client backups
Volumes, folders, and files that were originally backed up from other Avamar client
types are fully browsable by Avamar Administrator. However, these entities cannot be
restored to an NAS system.
Overwrite behavior
None of the overwrite and open file options are applicable when performing an NDMP
restore. This is an inherent limitation of NDMP, which always overwrites existing files
when restoring.
Web services restores with external authentication
You cannot restore data from an NDMP backup using Avamar Web services if the user
who initiates the restore is authenticated using an external authentication system such
as LDAP or Windows Active Directory.
Restoring non-UTF8 characters
Default Oracle ZFS filesystems only support UTF-8 characters. Therefore, if you will
be restoring files that contain non-UTF-8 characters to the Oracle ZFS storage
appliance, you must create a new filesystem on the Oracle ZFS storage appliance that
will support non-UTF-8 characters. Otherwise, the restore will fail.
Creating an Oracle ZFS filesystem for non-UTF-8 restores
Default Oracle ZFS filesystems only support UTF-8 characters. Therefore, if you will
be restoring files that contain non-UTF-8 characters to the Oracle ZFS storage
appliance, you must create a new filesystem on the Oracle ZFS storage appliance that
will support non-UTF-8 characters. Otherwise, the restore will fail.
Note
This task is only required if you are restoring files that contain non-UTF-8 characters
to the Oracle ZFS storage appliance.
Procedure
1. Open a web browser and type the following URL:
https://oracle-zfs:215
where oracle-zfs is the Oracle ZFS storage appliance network hostname or IP
address.
The login web page appears.
2. Type the superuser (root) Username and Password, and then click LOGIN.
The dashboard web page appears.
3. On the dashboard web page, click Shares.
4. Click + next to Filesystems.
The Create filesystem web page appears.
5. Clear the Reject non UTF-8 checkbox.
44
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Restore
6. Click Apply.
Restoring to the original NAS system
This task restores data from an NDMP backup to the original NAS system.
Procedure
1. In Avamar Administrator, click the Backup & Restore launcher link.
The Backup & Restore window appears.
2. From the list of clients, select the accelerator.
A list of NAS system clients registered with that accelerator appears in the
lower pane.
3. Select the NAS system client instance.
4. Click the Restore tab.
5. Click the By Date tab.
Valid backups occurred on dates with a yellow highlight.
6. Select the backup date from the calendar.
A list of backups on that date appears in the Backups table next to the
calendar.
7. Select a backup from the Backups table.
8. In the lower-right pane, expand the folder tree to view a list of volumes.
9. Select the checkbox next to the volume in the left section of the Contents of
Backup pane.
The files and folders on the volume appear in the right section of the Contents
of Backup pane.
10. (Optional) To restore individual folders or files, select the checkbox next to
each folder or file you want to restore.
11. Select Actions > Restore Now.
The Restore Options dialog box appears.
12. Ensure that the correct plug-in is selected in the Restore Plug-in list.
13. From the Avamar encryption method list, select the encryption method for
data transfer between the Avamar server and the client during the restore.
The encryption technology and bit strength for a client/server connection
depends on several factors, including the client operating system and Avamar
server version. The Avamar Product Security Guide provides details.
14. Select Restore everything to its original location.
15. (Optional) Set plug-in options:
These settings are all optional. In most cases, system default settings are the
optimum settings for restores.
a. Click More Options.
The Restore Command Line Options dialog box appears.
b. From the Maximum Concurrent Data Streams list, select the maximum
number of data streams that can be utilized concurrently during the restore.
Restoring to the original NAS system
45
Restore
c. To run a script before the restore operation starts, type a script file name in
the Run user-defined script at start of restore field. The script must
reside in the accelerator /usr/local/avamar/etc/scripts directory.
d. To run a script after the restore operation ends, type a script file name in the
Run user-defined script at end of restore field. The script must reside in
the accelerator /usr/local/avamar/etc/scripts directory.
e. To manually enter other plug-in options as free text, click More, type to
plug-in option name and value in the Enter Attribute and Enter Attribute
Value fields, respectively, and then click + (Add to list).
f. Click OK.
The Restore Command Line Options dialog box closes.
16. Click OK to close the Restore Options dialog box.
Restoring to a Linux or Windows client
This task restores data from an NDMP backup to a Linux or Windows client file
system. After NDMP data is restored to an Avamar Linux or Windows client, the data
can be easily accessed and shared by establishing an NFS mount on Linux systems, or
a CIFS mount on Windows systems.
Procedure
1. In Avamar Administrator, click the Backup & Restore launcher link.
The Backup & Restore window appears.
2. From the list of clients, select the accelerator.
A list of NAS system clients registered with that accelerator appears in the
lower pane.
3. Select the NAS system client instance.
4. Click the Restore tab.
5. Click the By Date tab.
Valid backups occurred on dates with a yellow highlight.
6. Select the backup date from the calendar.
A list of backups on that date appears in the Backups table next to the
calendar.
7. Select a backup from the Backups table.
8. In the lower-right pane, expand the folder tree to view a list of volumes.
9. Select the checkbox next to the volume in the left section of the Contents of
Backup pane.
The files and folders on the volume appear in the right section of the Contents
of Backup pane.
10. (Optional) To restore individual folders or files, select the checkbox next to
each folder or file you want to restore.
11. Select Actions > Restore Now.
The Restore Options dialog box appears.
46
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Restore
12. Select the destination Linux or Windows client:
a. Click the Browse button next to the Restore Destination Client field.
The Browse for Client Destination dialog box appears.
b. Browse to and select the destination client.
c. Click OK.
The Browse for Client Destination dialog box closes.
13. Ensure that the correct plug-in is selected in the Restore Plug-in list.
14. From the Avamar encryption method list, select the encryption method for
data transfer between the Avamar server and the client during the restore.
The encryption technology and bit strength for a client/server connection
depends on several factors, including the client operating system and Avamar
server version. The Avamar Product Security Guide provides details.
15. Select Restore everything to a different location.
The buttons below the Items Marked for Restore list become active.
16. Click Set Destination.
The Set Destination dialog box appears.
17. Click Browse.
The Browse for File, Folder, or Directory dialog box appears.
18. Expand the list in the left pane, and then select the checkbox next to the target
volume.
19. Click OK.
The Browse for File, Folder, or Directory dialog box closes.
20. In the Restore Options dialog box, click More Options.
21. (Optional) Set plug-in options:
These settings are all optional. In most cases, system default settings are the
optimum settings for restores.
a. Click More Options.
The Restore Command Line Options dialog box appears.
b. From the Maximum Concurrent Data Streams list, select the maximum
number of data streams that can be utilized concurrently during the restore.
c. To run a script before the restore operation starts, type a script file name in
the Run user-defined script at start of restore field. The script must
reside in the accelerator /usr/local/avamar/etc/scripts directory.
d. To run a script after the restore operation ends, type a script file name in the
Run user-defined script at end of restore field. The script must reside in
the accelerator /usr/local/avamar/etc/scripts directory.
e. To manually enter other plug-in options as free text, click More, type the
plug-in option name and value in the Enter Attribute and Enter Attribute
Value fields, respectively, and then click + (Add to list).
f. Click OK.
The Restore Command Line Options dialog box closes.
Restoring to a Linux or Windows client
47
Restore
22. Click OK to close the Restore Options dialog box.
Monitoring restores
You can monitor restores to ensure a successful completion of restores and
troubleshooting of issues. The Activity Monitor in Avamar Administrator enables you
to view status information for restores.
Procedure
1. In Avamar Administrator, click the Activity launcher link.
The Activity window appears.
2. Click the Activity Monitor tab.
A list of all activities appears.
3. To filter the results to display only restore activity, select Actions > Filter.
The Filter Activity dialog box appears.
4. Select Restore from the Type list.
5. Click OK.
Canceling restores
You can cancel a restore any time before it completes. The cancellation might take 5
minutes or longer. The restore may complete before the cancellation finishes.
Procedure
1. In Avamar Administrator, click the Activity launcher link.
The Activity window appears.
2. Click the Activity Monitor tab.
A list of all activities appears.
3. Select the restore from the list.
4. Select Actions > Cancel Activity.
A confirmation message appears.
5. Click Yes.
48
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
CHAPTER 5
Best Practices
This chapter includes the following topics:
Best Practices
49
Best Practices
50
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
APPENDIX A
Plug-in Options
This appendix includes the following topics:
l
l
l
How to set plug-in options................................................................................. 52
Backup options.................................................................................................. 52
Restore options..................................................................................................53
Plug-in Options
51
Plug-in Options
How to set plug-in options
Plug-in options enable you to control specific actions for on-demand backups,
restores, and scheduled backups. The available plug-in options depend on the
operation type and plug-in type.
Specify plug-in options in Avamar Administrator for on-demand backup or restore
operations, or when a dataset for a scheduled backup is created. Set plug-in options
with the graphical user interface (GUI) controls (text boxes, checkboxes, radio
buttons, and so forth). Type an option and its value in the Enter Attribute and Enter
Attribute Value fields.
NOTICE
The Avamar software does not check or validate the information that is typed in the
Enter Attribute and Enter Attribute Value fields. The values in the Enter Attribute
and Enter Attribute Value fields override settings that are specified with the GUI
controls for the options.
Backup options
These plug-in options are available when you perform an on-demand backup, or
configure a dataset using an NDMP plug-in.
Table 2 Backup plug-in options
52
Setting
Description
Maximum Concurrent Data Streams
Specifies the maximum number of streams
that can be processed concurrently.
Filer Dump Mode
One of the following values:
l
Prefer Incremental, but do a Full if
required
l
Force a level 0 dump
l
Force an incremental (level 1) dump
Backup label
Custom descriptive label for the backup.
This option is only available during on-demand
backups.
Run user-defined script at start of backup
File name of a script to be run before each
backup target is processed. The script must
reside in the accelerator /usr/local/
avamar/etc/scripts directory.
Run user-defined script at end of backup
File name of a script to be run after each
backup target is processed. The script must
reside in the accelerator /usr/local/
avamar/etc/scripts directory.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Plug-in Options
Restore options
These plug-in options are available when you perform a restore using an NDMP plugin.
Table 3 Restore plug-in options
Setting
Description
Maximum Concurrent Data Streams
Specifies the maximum number of streams
that can be processed concurrently.
Run user-defined script at start of restore
File name of a script to be run before each
restore target is processed. The script must
reside in the accelerator /usr/local/
avamar/etc/scripts directory.
Run user-defined script at end of restore
File name of a script to be run each restore
target is processed. The script must reside in
the accelerator /usr/local/avamar/etc/
scripts directory.
Restore options
53
Plug-in Options
54
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
APPENDIX B
Command Line Interface
This appendix includes the following topics:
l
l
l
avndmp.............................................................................................................. 56
Specifying command line options........................................................................61
Script processing................................................................................................61
Command Line Interface
55
Command Line Interface
avndmp
The avndmp command provides a Command Line Interface (CLI) for backing up and
restoring data to supported NAS systems.
The avndmp binary is located in the accelerator /usr/local/avamar/bin
directory.
To use the avndmp CLI:
1. Open a command shell.
2. Log in to the accelerator as admin.
3. Switch the user to root by typing the following command:
su -
4. Type the avndmp commands and options.
Syntax
avndmp {
{--backup | --operation=backup} [backup options]
| {--browse | --operation=browse}
| {--restore | --operation=restore} [restore options]
}
[account options] [common options] [logging options]
Operation descriptors
Supply only one operation on each avndmp command line.
--backup
--operation=backup
Performs an on-demand backup of a NAS system.
--browse
--operation=browse
Displays the volumes for the connected NAS.
--restore
--operation=restore
Restores data to a NAS system, or to an Avamar Linux or Windows client.
Account options
Account options for the avndmp command enable you to specify credentials to
connect to the Avamar server for backups and restores.
--acceladdr=accelerator-name
Specifies the accelerator IP address or fully qualified hostname.
--account=path
--acnt=path
--path=path
Specifies an account location (path) on the Avamar server.
--fileraddr=nas-name
56
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Command Line Interface
Specifies the NAS system IP address or fully qualified hostname.
--filertype={md5 | text}
Specifies whether NAS system uses plain text (text) or encrypted (md5)
passwords to authenticate the --fileruser account.
--fileruser=user
--filerpswd=password
Specifies the NAS system user account and password that runs NDMP jobs.
--hfsaddr=avamar-server-name
--server=avamar-server-name
Specifies the Avamar server IP address or fully qualified hostname (as defined in
DNS).
--id=user@auth
--password=password
--ap=password
--pswd=password
Specifies a login user account and password on the Avamar server, where:
l
l
l
user is the username.
auth is the authentication system that is used to authenticate that user. The
default internal authentication system is avamar.
password is the password
Common options
Common options can be supplied with any operation.
--appname=name
Specifies which application to run. The default application is avndmp.
--backup-type={differential | differential_full | incremental |
incremental_full | level0_full | metadata | synthetic_full}
Specifies a backup type.
--check_filer_version
--check-filer-version
Verifies that the NAS system is a supported version.
--check_ndmp_enabled
--check-ndmp-enabled
Verifies that NDMP services are enabled on the NAS system.
--check_password
--check-password
Verifies that the NAS system username and password are valid.
--env=string
Specifies custom variables to be sent to the NAS system.
--filerbrand={EMC | NetApp}
Specifies the brand of NAS system.
avndmp
57
Command Line Interface
l
EMC—For Celerra, Unity, VNX, VNXe, or Isilon storage systems.
l
NetApp—For NetApp filers.
l
zfs—For Oracle ZFS storage appliances.
--flagfile=path
Specifies the path to an options (flag) file.
--help
Shows all help output for the avndmp command, and then exits.
Supplying an operation descriptor shows help for that specific operation, and
then exits.
--home=path
Specifies the home directory path.
--pluginport=port
Specifies the avagent data port connections. The default data port setting is
28002.
--run-at-end=script
--run_at_end=script
Runs this script after each target is backed up or restored. The script must reside
in the accelerator /usr/local/avamar/etc/scripts directory.
--run-at-end-clauses=clauses
--run_at_end_clauses=clauses
Uses these clauses to start the run-at-end script. The default setting is
desc=run-at-end.
--run-at-start=script
--run_at_start=script
Runs this script before each target is backed up or restored. The script must
reside in the accelerator /usr/local/avamar/etc/scripts directory.
--run-at-start-clauses=clauses
--run_at_start_clauses=clauses
Uses these clauses to start the run-at-start script. The default setting is
desc=run-at-start.
--version
Shows version, then exits.
Logging options
Logging options enable you to specify the path and file name for the avndmp log file,
and to control how much information the plug-in writes to the log file.
--informationals
Adds informational status messages to logging output. This is enabled by default.
--logfile=file
--log=file
Specifies the full path and file name of the log file.
58
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Command Line Interface
--logtimeformat={ default | iso}
--logfmt={ default | iso}
Specifies the date and time format for log file time stamps.
--logtimezone={default | local | gmt/utc}
--logzone={default | local | gmt/utc}
Specifies the time zone for log file time stamps.
--noinformationals
Turns off all status messages.
--nostdout
Turns off output to standard output (stdout).
--nowarnings
Turns off warning messages.
--prefix=string
Specifies a string to be prefixed to the log files.
--quiet
Suppresses informational and warning messages.
--verbose [=n]
--v [=n]
Enables all status and warning messages.
Specifies an optional verbosity level by adding =n, where n is a positive singledigit integer between 1 and 6. The default verbosity level setting is 6.
Backup options
--base-sequencenumber=num
--base-labelnum=num
Explicitly sets which backup to use as the incremental base. The default setting is
-1.
--enable-multivolume
Enables support for multiple volumes in a single backup.
--exclude-list=path/pattern
Specifies one or more directories or files to exclude from backups. The following
rules apply:
l
l
l
path must be the target path that contains files or directories that match
pattern.
pattern can contain asterisk (*) or question mark (?) wildcards.
n
An asterisk (*) matches zero or more occurrences of any character.
n
A question mark (?) matches a single occurrence of any character.
Multiple --exclude-list options are allowed on the same command line.
--expires={n | days=n | weeks=n | months=n | years=n | timestamp}
Specifies backup expiration as one or more of the following:
avndmp
59
Command Line Interface
l
A specific number of days (n or days=n)
l
A specific number of weeks (weeks=n)
l
A specific number of months (months=n)
l
A specific number of years (years=n)
l
An absolute timestamp
--full
Performs a full backup.
The --full and --incremental options are mutually exclusive.
--incremental
Performs an incremental backup.
The --full and --incremental options are mutually exclusive.
--limit-incremental-search=num
Specifies the maximum number (num) of past backups to search for a valid
incremental base. Specify 0 for unlimited searching. The default setting is 30 past
backups.
--mode={full | incremental | try_incremental}
Specifies backup processing mode.
--noavtar=stream
Specifies a NAS system data stream name (stream) to be stored in a file.
--retention-type={none | daily | weekly | monthly | yearly}
--retentiontype={none | daily | weekly | monthly | yearly}
Specifies an extended retention type for the backup.
--savedump=stream
Saves the dump stream to a file using a tee.
--test-comment-file-omits=string
Omits creation of listed comment files in either the target or the
snapview .system_infos file.
Restore options
-restore-destination={none | original | single | multiple}
--restore-option=
Specifies the type of restore to perform.
--restoretarget=name
--target=name
Specifies where to restore data, if different from original location.
Limitations
The known limitation of avndmp CLI for backing up and restoring data is as follows:
l
60
Oracle ZFS file system does not support file level backup, but it supports file level
restore.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Command Line Interface
Specifying command line options
Use one of the following methods to specify options for the avndmp command:
l
Type the individual options on the command line.
l
List the options in the avndmp.cmd file, located in the accelerator \usr\local
\avamar\var\client-account-name directory. List each option on its own
line. For example:
--id=user@auth-system
-password=password
--logfile=file
--verbose
l
Create a plain text option file, listing each option on its own line, and then specify
the option file path on the command line using the --flagfile=path option.
Script processing
The avndmp CLI enables user-defined scripts to be run before or after each backup or
restore operation.
Script location
Scripts must reside in the accelerator /usr/local/avamar/etc/scripts
directory.
Targets
Each backup or restore operation can comprise multiple targets. Each target is
processed separately by Avamar, and any user-defined scripts are successively run
against each target before the next target is processed.
Pre- and post-processing control
The --run-at-start=script and --run-at-start-clauses options control preprocessing. That is, script is run against each target before Avamar attempts to back
up or restore it.
The --run-at-end=script and --run-at-end-clauses options control postprocessing. That is, script is run against each target after Avamar has successfully
backed up or restored it.
Script parameter syntax
There are two distinct syntaxes for passing parameters into scripts using the --runat-start and --run-at-end options.
l
If stringlist-args or list clauses are false or not supplied, then parameters
(p1, p2) are passed into script separated by white space. For example:
--run-at-end="script p1 p2"
l
If stringlist-args or list clauses are true, then parameters (p1, p2) are passed
into script separated by commas. For example:
--run-at-start="script,p1,p2"
Specifying command line options
61
Command Line Interface
Mixing syntaxes (for example, separating parameters with white space when the
stringlist-args clause is true) will prevent the script from running.
Script clauses
The --run-at-start-clauses and --run-at-end-clauses options accept any
of the following clauses. The following table lists and describes each clause. The
Default (not supplied) column lists the default behavior (that is, behavior that occurs
if the clause is not supplied). The No value columns lists the behavior used if the
clause is supplied without a value (for example, exit-on-error).
Table 4 Script clauses for the --run-at-start-clauses and --run-at-end-clauses options
Clause
Default (not supplied)
desc=text
run-at-end for --run-atend-clauses
No value
Description
Adds this user-defined
descriptive text in log
messages.
run-at-start for --runat-start-clauses
env="key=value"
Specifies environment
variable to be set before
running the script.
exit-on-error[={true |
false}]
false
true
Causes the program to exit
when the script returns an
error or times out.
If exit-on-error and skip-onerror are both specified, then
exit-on-error takes
precedence.
skip-on-error[={true |
false}]
false
true
Causes the program to skip
the current operation if the
script returns an error or
times out.
This is only used with --runat-start-clauses to
specify that the backup or
restore operation should
continue even if an error is
encountered when processing
a single target.
If used with --run-at-endclauses, it is ignored
because the operation has
already completed on the
target.
If exit-on-error and
skip-on-error are both
specified, then exit-onerror takes precedence.
stringlist-args[={true
| false}], list[={true |
false}]
62
false
true
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Specifies the syntax used to
pass parameters into a script
Command Line Interface
Table 4 Script clauses for the --run-at-start-clauses and --run-at-end-clauses
options (continued)
Clause
Default (not supplied)
No value
Description
with the --run-at-start
or --run-at-end options.
If false or not supplied, then
parameters are specified
using white space as a
separator.
If true, then parameters are
specified as a commaseparated list.
Mixing syntaxes (for example,
separating parameters with
white space when the
stringlist-args clause is
true) will prevent the script
from running.
timeoutseconds[=integer ]
1 hour
1 hour
Specifies the maximum wait
time for the script to
complete.
create-stdoutpipe[={true | false}]
true
true
If true, sends stdout to log
file. If false, stdout output
from the script is lost.
create-stderrpipe[={true | false}]
true
true
If true, sends stderr from
script to log file. If false,
stderr output from the script
is lost.
Script processing
63
Command Line Interface
64
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
APPENDIX C
Troubleshooting
This appendix includes the following topics:
l
l
Log files............................................................................................................. 66
Restore problems and solutions......................................................................... 66
Troubleshooting
65
Troubleshooting
Log files
During backup and restore operations, the avagent process creates log files for
troubleshooting problems.
By default, avagent log files are located in the accelerator /usr/local/
avamar/var/client directory.
The avagent log file name and location can be customized for each backup or restore
operation:
where file is the full path and file name of the log file.
l
Supply a --logfile=file option on the command line interface
l
In Backup Options or Restore Options dialog boxes, type logfile in the Enter
Attribute, and file in the Enter Attribute Value fields.
l
In New Dataset or Edit Dataset dialog boxes, type logfile in the Enter
Attribute, and file in the Enter Attribute Value fields.
Restore problems and solutions
The following topics describe common restore problems and solutions.
Redirected restore of multiple volumes does not work
Redirected restore of multiple volumes fails and results in the following error:
avndmp Error <11803>: [avndmp_assist] Unable to redirect multiple
volumes. Please restore them separately
To work around this issue, restore each volume separately.
Issues with directed recoveries of VNX systems with space-reduced backup
enabled to non-NAS filesystems
Recovering files from an Avamar NDMP backup of a VNX deduplicated file-system
which has the Space-Reduced Backup parameter enabled may result in some files not
being readable when a directed recovery is performed to a non-NAS filesystem, such
as a Microsoft Windows or UNIX/Linux filesystem. This applies when:
l
The VNX Space-Reduced Backup threshold set to a value other than 0.
Note
Setting the Space-Reduce Backup parameter to 0 disables the Space-Reduced
backup feature.
l
One or more of the source files were automatically compressed by the VNX.
l
The restore involves a cross-platform recovery (for example, VNX to Windows or
VNX to Linux).
The Avamar KB article https://emcservice--c.na55.visual.force.com/apex/KB_ETA?
id=kA4j0000000PFpA contains further information.
66
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
GLOSSARY
A
accelerator
activation
The Avamar NDMP Accelerator (accelerator) is a specialized Avamar server node that,
when used as part of an Avamar system, enables backup and restore of network
addressed storage (NAS) systems by way of the network data management protocol
(NDMP).
The process of passing the client ID (CID) back to the client, where it is stored in an
encrypted file on the client file system.
See also client activation
Avamar Administrator
Avamar server
A graphical management console software application that is used to remotely
administer an Avamar system from a supported Windows or Linux client computer.
The server component of the Avamar client/server system. Avamar server is a faulttolerant, high-availability system that efficiently stores the backups from all protected
clients. It also provides essential processes and services required for data restores,
client access, and remote system administration. Avamar server runs as a distributed
application across multiple networked storage nodes.
B
backup
A point-in-time copy of client data that can be restored as individual files, selected data,
or as an entire backup.
C
client activation
The process of passing the client ID (CID) back to the client, where it is stored in an
encrypted file on the client file system.
See also activation
client registration
The process of establishing an identity with the Avamar server. When Avamar
recognizes the client, it assigns a unique client ID (CID), which it passes back to the
client during client activation.
See also registration
D
dataset
A policy that defines a set of files, directories, and file systems for each supported
platform that are included or excluded in backups across a group of clients. A dataset is
a persistent and reusable Avamar policy that can be named and attached to multiple
groups.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
67
Glossary
G
group
group policy
A level of organization in Avamar Administrator for one or more Avamar clients. All
clients in an Avamar group use the same group policies, which include the dataset,
schedule, and retention policy.
The dataset, schedule, and retention policy for all clients in an Avamar group.
M
MCS
Management console server. The server subsystem that provides centralized
administration (scheduling, monitoring, and management) for the Avamar server. The
MCS also runs the server-side processes used by Avamar Administrator.
N
NAS
NDMP
Network attached storage. A device connected to a computer network that provides
centralized file storage for other computers on the network. NAS systems always
provide storage in the form of a traversable file system.
Network data management protocol. An open protocol that is used to move data from a
NAS system to a backup server.
P
plug-in
plug-in options
Avamar client software that recognizes a particular kind of data resident on that client.
Options that you specify during backup or restore to control backup or restore
functionality.
R
registration
The process of establishing an identity with the Avamar server. When Avamar
recognizes the client, it assigns a unique client ID (CID), which it passes back to the
client during client activation.
See also client registration
restore
retention
68
An operation that retrieves one or more file systems, directories, files, or data objects
from a backup and writes the data to a designated location.
The time setting to automatically delete backups on an Avamar server. Retention can be
set to permanent for backups that should not be deleted from an Avamar server.
Retention is a persistent and reusable Avamar policy that can be named and attached to
multiple groups.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Glossary
S
schedule
The ability to control the frequency and the start and end time each day for backups of
clients in a group. A schedule is a persistent and reusable Avamar policy that can be
named and attached to multiple groups.
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
69
Glossary
70
Avamar NDMP Accelerator for Oracle ZFS 7.5.1 User Guide
Download PDF
Similar pages