emc avamar 7.0 extended retention · emc avamar 7.0 extended retention user guide 7 preface as part...

EMC® Avamar® 7.0Extended Retention

User GuideP/N 300-015-243REV 01

EMC Avamar 7.0 Extended Retention User Guide2

Copyright © 2001- 2013 EMC Corporation. All rights reserved. Published in the USA.

Published July, 2013

EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

EMC2, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and other countries. All other trademarks used herein are the property of their respective owners.

For the most up-to-date regulatory document for your product line, go to the technical documentation and advisories section on the EMC online support website.

CONTENTS

Preface

Chapter 1 Introduction

Overview..................................................................................................... 12 Capabilities and limitations ........................................................................ 13

Avamar extended retention requires Avamar 7.0 ................................... 13Avamar extended retention is intended for long-term retention ............. 13Exports and imports can take a significant amount of time .................... 13A single physical or virtual tape library is supported.............................. 13Standalone tape drives are not supported............................................. 13

Important terms and definitions.................................................................. 14 Operational best practices .......................................................................... 15

Creating an administrative user account................................................ 15Exporting backups to tape..................................................................... 15Labeling tape volumes .......................................................................... 16Creating disaster recovery images ......................................................... 16Clearing the browser cache before logging in for the first time ............... 16

Chapter 2 Getting Started

Supported browsers.................................................................................... 18 What to do the first time you use Avamar extended retention ...................... 18 Logging in for the first time.......................................................................... 18

Login failures ........................................................................................ 19Session timeouts .................................................................................. 20

The Administration workspace .................................................................... 20Accessing available workspaces ........................................................... 21Adding and removing springboards....................................................... 22Moving springboards within a workspace.............................................. 22Displaying springboards in a workspace ............................................... 23Hiding springboards in a workspace...................................................... 23

The Avamar Extended Retention workspace................................................. 23 Customizing My Workspace......................................................................... 24

Copying springboards from other workspaces to My Workspace............ 24Adding springboards to the Springboards list in My Workspace............. 24Removing springboards from the Springboards list in My Workspace .... 25

Using online help........................................................................................ 26Avamar Extended Retention online help ................................................ 26Springboard and page-level help........................................................... 27

Logging out................................................................................................. 27

Chapter 3 Using the Administration Workspace

User management....................................................................................... 30The User Management springboard....................................................... 30Searching for a user .............................................................................. 30Creating a user account......................................................................... 30Editing a user account........................................................................... 31Disabling a user account ....................................................................... 32

Contents 3

Contents

Unlocking a user account ...................................................................... 33 Role management ....................................................................................... 33

The Role Management springboard ....................................................... 33Types of roles........................................................................................ 34Editing a user’s roles............................................................................. 34Generating a user role report ................................................................. 36

User profile management ............................................................................ 36The My Profile springboard.................................................................... 36Changing a user name or an email address ........................................... 37Changing a password............................................................................ 37Changing email message settings ......................................................... 38

System configuration .................................................................................. 39The Framework Configuration springboard ............................................ 39Configuring system settings .................................................................. 39Enabling and disabling message settings.............................................. 40Enabling SNMP ..................................................................................... 41

System events ............................................................................................ 42The Event Summary springboard ........................................................... 42Viewing event details in the Event Viewer.............................................. 43

Tasks .......................................................................................................... 47The Task Summary springboard ............................................................ 47Viewing task details in the Task Viewer ................................................. 47

Security events ........................................................................................... 50The Security Events springboard ........................................................... 50Viewing event details in the Security Event Viewer................................. 51

Log information........................................................................................... 55The Log Information springboard........................................................... 55Viewing detailed log information........................................................... 56Saving log files...................................................................................... 56

Chapter 4 Using the Avamar Extended Retention Workspace

Opening Avamar Extended Retention springboards ..................................... 58The Media Management springboard .................................................... 59The Scheduled Exports springboard ...................................................... 59The Import & Restore springboard ......................................................... 60The Configuration springboard .............................................................. 60The Recent Events springboard ............................................................. 62The Task Monitoring springboard .......................................................... 64The Import & Export Job History springboard ......................................... 66

Managing library media .............................................................................. 66The Media Management page ............................................................... 66Working with custom tape pools ........................................................... 67Working with custom retention periods ................................................. 72Labeling volumes.................................................................................. 75Relabeling volumes to a different tape pool (not recommended) ........... 79Viewing library details ........................................................................... 81Viewing the tape volumes in the library ................................................. 82Viewing the backups on a tape volume ................................................. 82Ejecting tape volumes ........................................................................... 84Inventorying the contents of the library ................................................. 85

Exporting Avamar backups to tape .............................................................. 86The Export Policy Management page ..................................................... 86Creating an export policy....................................................................... 90Editing an export policy....................................................................... 101

4 EMC Avamar 7.0 Extended Retention User Guide

Contents

Activating or deactivating an export policy .......................................... 102Deleting an export policy..................................................................... 102Performing on-demand exports ........................................................... 103Viewing export job details for active policies in the Task Viewer .......... 104

Browsing and importing Avamar backups.................................................. 105Restore limitations .............................................................................. 105The Backup Browse/Import page......................................................... 106Locating exported backups ................................................................. 107Importing backups from tape .............................................................. 108Customizing columns in the Backup panel .......................................... 110Editing backup retention periods ........................................................ 111Resetting the Import Server ................................................................. 111Restoring imported backups to a client ............................................... 112

Generating an import and export job history report ................................... 112

Chapter 5 Administration

Customizing drop-down text in the login dialog box................................... 116 Configuring the maximum value for parallel jobs ....................................... 116 Changing the root password on the Media Access node ............................ 117 Configuring SNMP traps ............................................................................ 117

Configuring Avamar server traps.......................................................... 117Configuring tape management system traps........................................ 119The Management Information Base ..................................................... 121

Configuring the system to use an ACSLS library ......................................... 123 Viewing current software versions ............................................................. 127 Shutting down the Media Access node ...................................................... 127 Setting up a VMware vCenter client ........................................................... 127

Modifying the mcserver.xml file........................................................... 128Setting up the VMware vCenter client on the Media Access node......... 128

Chapter 6 Disaster Recovery

Definition of a disaster .............................................................................. 132 Creating a disaster recovery image ............................................................ 132 Recovering the Avamar extended retention server ..................................... 133

Install Avamar extended retention....................................................... 133Set up the lockbox password and the superuser account .................... 133Apply the Avamar extended retention disaster recovery image ............ 134Recover the bootstrap ......................................................................... 135

Chapter 7 Troubleshooting

Modifying software components – caveats................................................ 138 Import server issues.................................................................................. 138

The Import server does not display in the GUI...................................... 138The Import server appears to be offline in the GUI ............................... 140

External Avamar server issues ................................................................... 141Avamar servers incorrectly appear offline in the GUI ............................ 141Avamar servers do not appear in the GUI ............................................. 142Avamar server performance is affected by extended retention activities ..... 144

Import failures .......................................................................................... 144Import failed and did not display in the Avamar MC Activity Monitor.... 144Import failed and can be seen in the Import server's Avamar MC ......... 144

Contents 5

Contents

Backups do not appear in the Backup Browse/Import page................. 145An Avamar client does not appear in the Backup Browse/ Import page 145

Export failures........................................................................................... 146Exports are failing in general ............................................................... 146Exports do not appear in the Avamar MC and fail in extended retention...... 147An export failed and appears in the MC Activity Monitor ...................... 148Not all exports were written to tape, but the export task completed..... 148The Event Viewer indicates that an export event was skipped.............. 148An export worked but the client is not in the import list ....................... 148

Jobs take a long time to run....................................................................... 148 Library issues............................................................................................ 148

The library does not appear in the GUI................................................. 148The library appears as UNKNOWN in the GUI ....................................... 149An eject tape request failed................................................................. 150

A task failed or completed with exceptions................................................ 150 The file index is reporting that it is full....................................................... 150 JavaScript errors........................................................................................ 151 Timeout messages .................................................................................... 151

Index


PREFACE

As part of an effort to improve its product lines, EMC periodically releases revisions of its software and hardware. Therefore, some functions 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 your EMC technical support professional if a product does not function properly or does not function as described in this document.

Note: This document was accurate at publication time. Go to EMC Online Support (https://support.emc.com) to ensure that you are using the latest version of this document.

PurposeThis document describes how to use the Avamar extended retention feature.

AudienceThis document is intended for system administrators who will be using the Avamar extended retention feature.

Revision historyThe following table presents the revision history of this document.

Related documentationThe following EMC publications provide additional information:

EMC Avamar 7.0 Extended Retention Release Notes EMC Avamar 7.0 Extended Retention Security Guide EMC Avamar 7.0 Media Access Node Customer Hardware Installation Guide EMC Avamar Compatibility and Interoperability Matrix EMC Avamar Data Store Gen4 Customer Service Guide EMC Avamar Data Store Site Prep Technical Specifications

Table 1 Revision history

Revision Date Description

01 July 10, 2013 Initial release of Avamar 7.0.

EMC Avamar 7.0 Extended Retention User Guide 7

http://support.emc.com

Conventions used in this documentEMC uses the following conventions for special notices:

DANGER indicates a hazardous situation which, if not avoided, will result in death or serious injury.

WARNING indicates a hazardous situation which, if not avoided, could result in death or serious injury.

CAUTION, used with the safety alert symbol, indicates a hazardous situation which, if not avoided, could result in minor or moderate injury.

NOTICE is used to address practices not related to personal injury.

Note: A note presents information that is important, but not hazard-related.

IMPORTANT

An important notice contains information essential to software or hardware operation.

Typographical conventions

EMC uses the following type style conventions in this document:

Bold Use 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 Use for full titles of publications referenced in text

Monospace Use for:• System output, such as an error message or script• System code• Pathnames, filenames, prompts, and syntax• Commands and options

Monospace italic Use for variables.

Monospace bold Use 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 omitted from the example


Where to get helpThe Avamar support page provides access to licensing information, product documentation, advisories, and downloads, as well as how-to and troubleshooting information. This information may enable you to resolve a product issue before you contact EMC Customer Service.

To access the Avamar support page:

1. Go to the following URL:

https://support.EMC.com/products

2. Type a product name in the Find a Product box.

3. Select the product from the list that appears.

4. Click the arrow next to the Find a Product box.

5. (Optional) Add the product to the My Products list by clicking Add to my products in the top 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. Review the following documents in addition to product administration and user guides:

Release notes provide an overview of new features and known limitations for a release.

Technical notes provide technical details about specific product features, including step-by-step tasks, where necessary.

White papers provide an in-depth technical perspective of a product or products as applied to critical business issues or requirements.

Knowledgebase

The EMC Knowledgebase contains applicable solutions that you can search for either by solution number (for example, esgxxxxxx) or by keyword.

To search the EMC Knowledgebase:

1. Click the Search link 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 the search button.

Online communities

Visit EMC Community Network (https://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 EMC products.

EMC Avamar 7.0 Extended Retention User Guide 9

https://support.emc.com/products

Live chat

To engage EMC Customer Service 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 EMC Customer Service, submit a service request by clicking Create Service Requests on the Service Center panel of the Avamar support page.

Note: To open a service request, you must have a valid support agreement. Contact your EMC sales representative for details about obtaining a valid support agreement or with questions about your 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.

Facilitating support

EMC recommends that you enable ConnectEMC and Email Home on all Avamar systems:

ConnectEMC automatically generates service requests for high priority events.

Email Home emails configuration, capacity, and general system information to EMC Customer Service.

Your commentsYour suggestions help us to continue to improve the accuracy, organization, and overall quality of the user publications. Send your opinions of this document to:

[email protected]

Please include the following information:

Product name and version Document name, part number, and revision (for example, 01) Page numbers Other details that will help us address the documentation issue


mailto:[email protected]

CHAPTER 1Introduction

The following topics provide a high-level overview of Avamar extended retention, which is a feature of the core Avamar software product. The extended retention feature is a long-term retention solution that exports Avamar backup data to a physical or virtual tape library.

Overview................................................................................................................. 12 Capabilities and limitations .................................................................................... 13 Important terms and definitions.............................................................................. 14 Operational best practices ...................................................................................... 15

Introduction 11

Introduction

OverviewThe Avamar extended retention feature is a solution that exports backup data from an Avamar server to a tape library (physical or virtual) for long term retention purposes. Administrators can import (or restore) this backup data from tape as needed. A dedicated server, called the Media Access node, hosts the feature. Tape devices connect directly to the node with fiber-optic cable.

The Avamar extended retention feature fully automates the execution of customer-defined export policies. These policies specify the Avamar backups to export, the schedules on which those backups export, and the retention periods for which the backups and information about them will remain on tape. Avamar extended retention streams the backups directly to tape, in rehydrated format, without staging the data during the export process. When the backups are imported from tape, they are staged onto an instance of the Avamar server software that is installed on the Media Access node.

The Avamar extended retention feature allows users to browse backups that have been exported to tape before selecting specific backups for import. The feature also provides alerts for exceptions and historical reporting.

The following figure illustrates the processes for exporting Avamar backups to tape through the Media Access node, and for restoring them to an Avamar client.

Backup data is exported from either an Avamar or a Data Domain server, and is streamlined through the Media Access node and written to tape in a physical or virtual tape library. Data that has been exported to tape can be imported back to the Avamar server on the Media Access node, and then restored directly to a compatible Avamar client.


Introduction

Capabilities and limitationsThe Avamar extended retention feature provides several capabilities and benefits to customers, including:

Allowing customers to put Avamar backups on tape Lowering the cost of storage for Avamar long-term retention of backups Producing transportable media for storing offsite Producing transportable media for restoring at an alternative site

The following topics describe limitations associated with the extended retention feature.

Avamar extended retention requires Avamar 7.0

The Avamar extended retention feature is included in the Avamar 7.0 release. Customers must also upgrade the Avamar grids that the extended retention feature will use to Avamar 7.0.

Avamar extended retention is intended for long-term retention

Avamar extended retention is to be used for long-term retention of data, and is not intended for operational recovery purposes. Administrators can use this feature to initiate the import of backups that have been exported to tape. However, the feature is not intended for end-users to perform their own imports. The feature is also not suitable for use as an alternative to replication or for use as a complete disaster recovery solution.

Exports and imports can take a significant amount of time

Exports and imports may take a long time depending upon the amount of data that is involved.

A single physical or virtual tape library is supported

Currently, Avamar extended retention can export Avamar backups to a single physical or virtual tape library. The use of multiple libraries is not supported.

Standalone tape drives are not supported

Avamar extended retention requires the use of a tape library with a robotic arm, or an equivalent virtual tape library. Standalone tape drives are not supported.

Avamar extended retention must also have exclusive control of the tape library and all drives that are allocated to it. The first release of the feature has not been designed to coordinate access with any other tape management implementation.

Capabilities and limitations 13

Introduction

Important terms and definitionsThe following terms are used throughout this guide.

Avamar extended retention agent The Avamar extended retention software component, which transforms a backup data stream from Avamar format into a proprietary format (during export) and vice versa (during restore). The agent is one of several distinct components that collectively make up the extended retention feature.

Avamar extended retention application The Avamar extended retention software component where the overall extended retention capability is administered. The Avamar extended retention application maintains schedules and policies, kicks off jobs accordingly and drives the extended retention user interface.

BackupAn object that contains all the data that an Avamar client or plug-in stores about a filesystem or application at the time a backup is created. The Avamar term is Dataset.

Backup metadataAttributes of the backups that have been exported by Avamar extended retention, such as the host machine it was taken from, the date/time it was taken, and the tape(s) it was exported to.

EjectThe action of unloading a tape from a tape drive or off-line storage slot (library) for the purpose of physically relocating the media to another location.

Export The action of transporting (extracting) a backup from an Avamar server and ultimately writing it onto long-term storage media.

External Avamar serversThe Avamar servers (also known as grids) whose backups will be exported to tape. In this guide, these servers are referred to as “external” to distinguish them from the import server.

Export policyDefines the schedule on which a group of client backups will be exported to tape by Avamar extended retention. The export policy defines the group of clients that share a common schedule and retention periods for backup metadata and file-level metadata.

ImportThe first phase of performing a restore operation, during which backups are transferred from tape to the internal Avamar server instance residing on the Media Access node.

Import serverThe Avamar server that is installed on the Media Access node. Backups are imported from tape to this server.

Media Access nodeA 7.8 TB, Gen4 node that has an HBA port, which allows a tape device to be connected directly to the node via fiber-optic cable. Avamar extended retention and an instance of Avamar run on this node.


Introduction

RestoreThe action of recovering a backup from long-term storage media to a target client machine such that the data is returned to its original state at the time the backup was taken by the original Avamar server.

Retention periodsConfigurable options for backups and the files contained in the backups. The retention period specifies how long the backups and files can be browsed in the system. After a retention period lapses, the backups do not expire until a disaster recovery image is created.

SpringboardA control feature that displays in a workspace. Springboards allow you to view status and schedule information, to configure system settings, to view events, logs, and tasks, to manage users, and to open additional web pages in which you can perform key configuration and administrative tasks within Avamar extended retention.

Storage Management SystemThe Avamar extended retention software component that manages the library and tape media.

WorkspaceA web page in the Avamar extended retention user interface that contains springboards that are used to perform specific tasks. Currently, the user interface provides three workspaces: Administration, Avamar Extended Retention, and My Workspace.

Operational best practicesThe following best practices provide tips for helping to ensure the most efficient operation of the Avamar extended retention system.

Creating an administrative user account

The first time you log in to the Avamar Extended Retention application, you have to provide credentials for the super user account, suser. This account should be reserved for performing administrative activities only, such as dealing with emergencies and lockouts.

We recommend that, after you have logged in as suser, you immediately create a new user account and assign all available roles to the user with the exception of the EMC Support role, which is for internal purposes only. Instructions for creating user accounts and assigning roles are provided in “Creating a user account” on page 30 and in “Editing a user account” on page 31.

Exporting backups to tape

Make sure that the export policy schedules line up with the Avamar backups in such a way that exports to tape happen only once after a backup is executed. Instructions for creating export policies are provided in “Creating an export policy” on page 90.

After you create an export policy, run it once manually, and verify that the expected number of jobs are running.

Operational best practices 15

Introduction

To verify the expected number of jobs:

1. Open the Task Viewer.

2. When the export policy shows as being in Active state, click the information icon next to it and make sure that the number of jobs running and waiting match what you expect.

If the number is not what you expect, one option is to increase the number of maximum jobs that can run in parallel. This setting is under System Properties in the Media Access node tab on the Configuration springboard. However, be aware that increasing this number directly impacts the performance of the external grids.

Do not run exports during maintenance or blackout windows that are scheduled on the external Avamar servers.

Always make sure that the library has labeled media available for exports.

Labeling tape volumes

Label at least two tape volumes as bootstrap tapes. Instructions for labeling bootstrap tapes are provided in “Labeling volumes” on page 75.

Labeling tapes can take time. After initiating a request to label a tape, verify that it has been labeled as follows:

1. Open the Event Viewer and wait for the “Successfully labeled volume xxx” event to appear.

2. In the Media Management page, make sure that the newly labeled tape shows as being labeled in the Volumes panel. (Volumes that have not been labeled have “unlabeled” in the Volume Name column.)

Creating disaster recovery images

Ask the administrator to set up a cron job to create a disaster recovery image automatically when the system is not busy with other tasks, such as exports and imports. Recovery images should be created regularly to ensure that the most current data possible can be recovered when needed. Instructions for creating a recovery image are provided in “Creating a disaster recovery image” on page 132.

Clearing the browser cache before logging in for the first time

If you have re-installed Avamar extended retention, delete the browser cache before logging in to the new installation for the first time.


CHAPTER 2Getting Started

The following topics describe how to log in to the Avamar Extended Retention user interface and how to use the workspaces that are available:

Supported browsers................................................................................................ 18 What to do the first time you use Avamar extended retention .................................. 18 Logging in for the first time...................................................................................... 18 The Administration workspace ................................................................................ 20 Customizing My Workspace..................................................................................... 24 The Avamar Extended Retention workspace............................................................. 23 Using online help.................................................................................................... 26 Logging out............................................................................................................. 27

Getting Started 17

Getting Started

Supported browsersThe Avamar extended retention application supports the following web browsers:

Microsoft Internet Explorer Mozilla Firefox Google Chrome

Refer to the EMC Avamar Compatibility and Interoperability Matrix for supported browser versions.

What to do the first time you use Avamar extended retentionThe first time you use the Avamar extended retention feature, perform the following tasks:

1. Log in Avamar extended retention, and set up the lockbox password and the framework administrator account as described in “Logging in for the first time”.

2. In the Administration workspace, create at least one user and assign administrator roles to the user as described in “Creating a user account” on page 30 and in “Editing a user’s roles” on page 34.

3. Access the Avamar Extended Retention workspace, and open springboards as described in “The Avamar Extended Retention workspace” on page 23 and in “Opening Avamar Extended Retention springboards” on page 58.

4. Label volumes in the library as described in “Labeling volumes” on page 75.

5. Create an export policy as described in “Creating an export policy” on page 90.

When the exports are running, you can begin monitoring events and tasks, and browsing and importing Avamar backups.

Logging in for the first timeThe first time you log in to Avamar extended retention, you must set a lockbox password and create an administrator account.

1. Open a web browser and type the following:

https//:media_access_node_IP_address:7443/imf.action

where media_access_node_IP_address is the IP address of the Media Access node on which the Avamar extended retention feature is running.

2. In the Setup Lockbox Password dialog box, type a lockbox password.

3. Type the password again to confirm it, and click Save Lockbox Changes.


Getting Started

The Create Framework Admin Account dialog box appears.

4. In the Create Framework Admin Account dialog box, type the name, email address, and password for the Avamar extended retention framework administrator account, suser.

The administrator, suser, will use this password to log in to the Avamar extended retention application, and can create additional users within the Administration workspace.

5. Click Save Administrator Account.

6. In the EMC Avamar Extended Retention login screen, type suser in the User Name box, and the password from step 4 in the Password box.

7. Click Login. The Administration workspace appears. See “The Administration workspace” on page 20 for instructions on using the workspace.

Login failures

If you type incorrect login information, the following Error appears.

Click OK and type the correct password in the Password box.

Logging in for the first time 19

Getting Started

If you exceed three login tries without entering the correct login information, an Error dialog box appears.

Click OK, and contact the administrator to unlock the account.

Each failed login attempt creates a warning security event.

Session timeouts

The amount of time a logged-in session remains active depends on the session timeout setting. The default setting is 45 minutes. No notification appears when a session times out; however, you cannot interact with the user interface after it has timed out. If the session times out, you must log back in to the Avamar extended retention application.

The Administration workspaceAfter you log in, you see the Administration workspace in the EMC Avamar Extended Retention page. The Administration workspace initially contains the springboards that display by default as shown in the following figure.


Getting Started

The Administration workspace also contains two tabs stacked vertically along the left side:

The WORKSPACES tab contains Avamar Extended Retention, My Workspace, and Administration.

The TOOLBAR tab contains an icon of the active workspace and a checklist of available springboards. When you select a springboard in the list, it appears in the workspace.

The list of springboards available on the TOOLBAR tab depends on the roles assigned to the user.

Accessing available workspaces

The WORKSPACES tab slides in and out when you click it. The WORKSPACES tab contains icons for My Workspace, Administration, and Avamar Extended Retention.

A workspace provides screen real estate for placing springboards. You can customize workspaces by adding or removing springboards, or by copying springboards to My Workspace.

Administration workspaceThe Administration workspace contains springboards that let you perform administrative tasks. “Using the Administration Workspace” on page 29 describes the springboards and the tasks that you can perform.

Avamar Extended Retention workspaceThe Avamar Extended Retention workspace contains springboards that let you manage the library media, and to export and import Avamar backups. “Using the Avamar Extended Retention Workspace” on page 57 describes the springboards and the tasks that you can perform.

The Administration workspace 21

Getting Started

My WorkspaceMy Workspace is a user-defined workspace. Initially, My Workspace contains three rectangles, which represent drop zones for springboards. My Workspace provides an area for you to organize frequently used springboards.

Adding and removing springboards

The TOOLBAR tab slides open and closed when you click it. When the TOOLBAR tab is open, it contains the icon for the active workspace and the Springboards list.

The Springboards list enables you to add or remove springboards to or from a workspace. The roles for the current user determine what springboards are available in the Springboards list.

1. Select the WORKSPACES tab, and click a workspace.

2. In the workspace, expand the TOOLBAR tab, and click the checkbox next to the springboard that you want to use.

You can also remove a springboard from a workspace.

1. Select the WORKSPACES tab, and click a workspace.

2. In the workspace, select the TOOLBAR tab, and clear the checkbox next to the springboard that you want to remove.

Moving springboards within a workspace

You can move a springboard to another location within a workspace by dragging and dropping it onto another springboard or onto a valid drop zone. Dotted rectangles indicate drop zones.

1. Click and hold the mouse cursor on the springboard's title bar.

2. Drag the springboard to a valid drop zone and drop it by releasing the mouse button.

The springboard appears as a transparent rectangle as you move it, and the mouse cursor changes to a icon to indicate an invalid drop zone.


Getting Started

Displaying springboards in a workspace

You can display any number of available springboards in a workspace. The TOOLBAR tab contains a list of available springboards.

1. Click the TOOLBAR tab.

2. Click the checkbox next to the springboard that you want to display.

Hiding springboards in a workspace

The springboards in each workspace contain a “hide from workspace” icon in the upper right corner.

1. Open the workspace in which you want to hide a springboard.

2. Click the “hide from workspace” icon.

The springboard no longer appears in the workspace.

The Avamar Extended Retention workspaceThe Avamar Extended Retention workspace is where you manage the library media, and where you export and import Avamar backup data to and from tape. See “Using the Avamar Extended Retention Workspace” on page 57 for instructions on using this workspace.

1. Click the WORKSPACES tab.

The WORKSPACES tab slides out.

2. In the WORKSPACES tab, click Avamar Extended Retention.

The Avamar Extended Retention workspace appears.

The Avamar Extended Retention workspace 23

Getting Started

By default, the Import & Restore, the Media Management, and the Scheduled Exports springboards are already open.

3. Click the TOOLBAR tab, and select other springboards that you want to view in the workspace.

Customizing My WorkspaceYou can customize My Workspace by copying springboards from other workspaces, and by adding springboards to the Springboards list.

Copying springboards from other workspaces to My Workspace

Each springboard in the Administration and Avamar Extended Retention workspaces contains a house icon in the upper right corner.

To copy a springboard to My Workspace, click the house icon on the springboard.

The springboard now appears in both my My Workspace and in the active workspace.

Adding springboards to the Springboards list in My Workspace

You can add more springboards to the list of springboards in My Workspace if needed.

1. Select the WORKSPACES tab, and then click My Workspace.

The My Workspace screen appears.

2. Select the TOOLBAR tab.

3. Under Springboards, click [edit].


Getting Started

The My Workspace Springboards dialog box appears.

4. In the Workspace list, select Administration or Avamar extended retention.

A list of springboards that are available for the selected workspace appears in the Available Springboards panel.

5. Select or clear checkboxes next to the springboard names:

• To include a springboard in the workspace's Springboards list, select the checkbox next to the springboard name.

• To exclude a springboard from the workspace's Springboards list, clear the checkbox next to the springboard name.

6. Repeat steps 4 and 5 to edit the Springboards list for the other workspace, or if finished, continue to step 7.

7. Click OK to save the changes, or click Cancel to close the dialog box without saving.

Removing springboards from the Springboards list in My Workspace

You can remove springboards from the Springboards list for My Workspace if preferred.

1. Select the WORKSPACES tab, and then click My Workspace.

The My Workspace screen appears.

2. Select the TOOLBAR tab.

Customizing My Workspace 25

Getting Started

3. In the Springboards list, click the “X” icon next to the springboard.

An Alert dialog box appears.

4. Click OK to remove the springboard from the Springboards list, or click Cancel to close the dialog box without removing the springboard.

Using online helpOnline help for Avamar extended retention is available in the user interface. You can open the entire help system, or you can open help topics that are specific to each springboard and page.

Avamar Extended Retention online help

You can view the entire Avamar Extended Retention online help system.

1. Click the question mark icon located in the upper right corner of the workspace.

The menu shown in the following figure appears.

2. Select an option from the menu:

• The Avamar Extended Retention Help link opens the online help for the application.

• The About EMC Avamar Extended Retention link opens a dialog box that contains copyright and version information about Avamar extended retention.


Getting Started

Springboard and page-level help

You can also view springboard and page-level online help.

Click the question mark icon in the upper right corner of a springboard to see a help topic that describes that springboard.

Click the question mark icon in the upper right corner of a page, and select the page name to display a topic that explains how to perform the tasks that are available on that page.

Logging outTo log out of the Avamar Extended Retention interface, click the door icon located in the upper right corner of the workspace.

Logging out 27

Getting Started


CHAPTER 3Using the Administration Workspace

The following topics describe the tasks that you can perform in the Administration workspace:

User management................................................................................................... 30 Role management ................................................................................................... 33 User profile management ........................................................................................ 36 System configuration .............................................................................................. 39 System events ........................................................................................................ 42 Tasks ...................................................................................................................... 47 Security events ....................................................................................................... 50 Log information....................................................................................................... 55

Using the Administration Workspace 29

Using the Administration Workspace

User managementThis topic describes how to manage Avamar extended retention users.

The User Management springboard

The User Management springboard enables an administrator (a user with the Administrator role) to create, edit, and disable user accounts. An administrator also uses the User Management springboard to unlock user accounts for users, who fail to log in after three tries.

Searching for a user

The User Management springboard allows you to search for and display users who match the search criteria.

1. Type the user’s last name in the Name box.

2. If you want to include the first name, type a comma and a space after the last name, and then type the first name.

Creating a user account

Anyone who logs in to Avamar Extended Retention must have a user account. By default, all new user accounts have the User role.

1. In the User Management springboard, click Create User.

The Create User dialog box appears.

Note: Red asterisks indicate required information.



2. In the User Name box, type a unique name. Maximum length is 32 alphanumeric characters. Do not use special characters, or leading or trailing spaces. The username is case insensitive.

3. In the First Name box, type the user's last name. Maximum length is 32 alphanumeric characters. Do not use special characters, or leading or trailing spaces.

4. In the Last Name box, type user's last name. Maximum length is 32 alphanumeric characters. Do not use special characters, or leading or trailing spaces.

5. In the Email Address box, type the user's email address in the standard email format:

[email protected]

Valid email addresses contain 5 to 64 characters.

6. For Status, select Active to enable the user account, or Inactive to disable it.

7. In the Password box, type a password from 8 to 32 characters. The password must contain at least 8 characters including uppercase characters and lowercase characters, one numeric character, and one special character from the following characters:

! @ # $ % ^ & * ( ) ? _ < > " : ; ', . /

Do not use any of the following characters in a password:

• Leading or trailing spaces• Minus (-), plus (+), or equal (=)

The password is case sensitive.

Note: For security, passwords are masked by asterisks.

8. In the Confirm Password box, type the password again to confirm it.

9. Click OK to create the user account, or Cancel to close the Create User dialog box without creating the user account.

Editing a user account

You can edit the name, email address, status, and password for a user account.

1. In the User Management springboard, type the user's last name or a portion of it in the Name box.

2. Select the user from the list of names that appears.

3. Click Edit User.

User management 31


The Edit User dialog box appears.


The table in “Creating a user account” on page 30 describes each text box.

4. Edit the information.

5. Click OK to continue editing, or Cancel to close the Edit User dialog box without saving the changes.

Disabling a user account

You cannot delete a user account from the application. You can only disable an account.

1. In the User Management springboard, type the user's last name or a portion of it in the Last Name text box.


3. Click Edit User.

The Edit User dialog box appears.

4. Select Inactive.

5. Click OK to disable the user, or Cancel to close the Edit User dialog box without saving changes.



Unlocking a user account

The software locks a user’s account after the user fails to log in after three attempts. The fourth login attempt and all subsequent logins result in an error message. When this happens, an administrator must unlock the account.

1. In the User Management springboard, type the user's last name or a portion of it in the Name box.


3. Click Edit User.

The Edit User dialog box appears with an additional option, Login Status.

4. Click the Locked icon next to Login Status.

The locked icon changes to an unlocked icon.

5. Click OK to unlock the user account, or Cancel to close the Edit User dialog box without saving changes.

The Login Status option only appears in the Edit User dialog box when a user's account is locked.

Role managementThis topic describes how to manage Avamar extended retention user account roles.

The Role Management springboard

The Role Management springboard enables an administrator to add or delete roles to or from a user account.

Roles enable a user to access the application’s components and functionality. The roles that a user has determine which springboards and events the user can access.

Role management 33


Types of roles

The following table describes the relationships between Avamar extended retention functions and the required roles.

Editing a user’s roles

Only users with the Administrator role can edit a user’s roles.

1. In the Role Management springboard, select the user whose roles you want to edit.

2. Click Edit User Roles.

Table 2 Avamar extended retention functions and required roles

Functions

Required roles

Administrator Auditor User

Create or edit users Yes No No

Create or apply images Yes No No

Edit configuration options Yes No No

Edit user roles Yes No No

Launch Event Viewer Yes No Yes

Launch Security Event Viewer No Yes No

Launch Task Viewer Yes No Yes

Make changes from My Profile springboard Yes Yes Yes

View Framework Configuration springboard Yes No No

View Event Summary springboard Yes No Yes

View Log Information springboard Yes No No

View My Profile springboard Yes Yes Yes

View Role Management springboard Yes No No

View Security Events springboard Yes Yes Yes

View Task Summary springboard Yes No Yes

View tasks in Task Viewer Yes No Yes

View threat level Yes Yes Yes

View User Management springboard Yes No No



The Edit Role Assignments dialog box appears in the Framework view, which lists the Framework roles that are available.

Note: The EMC Support role is for EMC Support use only. Do not select this role.

3. Select either the Framework or the Avamar Extended Retention component.

The following figure shows the roles for Avamar Extended Retention.

4. Select or clear checkboxes as needed to edit the user’s roles. When you clear a checkbox, the user no longer has that role.

5. Click OK to add or delete the roles for the selected user, or Cancel to close the Edit Role Assignments dialog box without saving changes.

Role management 35


Generating a user role report

The User Role Report contains user information, including the roles that each user has. To generate a user role report, click Generate Role Report in the Role Management springboard.

The report opens in a new browser tab if you are using tabs or in a new browser window if you are not. The following figure shows an example report.

User profile managementThis topic describes how to manage a user’s profile. To manage a user’s profile, you must log in as that user.

The My Profile springboard

The My Profile springboard enables you to make changes to a user’s profile.

Note: You must log in to a user account to make changes to that user’s profile.



Changing a user name or an email address

In the Change Information dialog box, you can change a user’s name and email address.

1. In the My Profile springboard, select Change information.

The Change Information dialog box appears.


2. In the First Name box, type the first name. Do not use special characters, or leading or trailing spaces. Maximum length is 32 alphanumeric characters.

3. In the Last Name box, type the last name. Do not use special characters, or leading or trailing spaces. Maximum length is 32 alphanumeric characters.

4. In the Email Address box, type the email address in the standard email format:

[email protected]

Valid email addresses contain 5 to 64 characters

5. Click OK to commit the changes, or Cancel to close the Change Information dialog box without saving changes.

Changing a password

In the Change Password dialog box, you can change a user’s password.

1. In the My Profile springboard, select Change password.

The Change Password dialog box appears.


2. Type the old password in the Old Password text box.

3. Type a new password in the New Password text box.

The password must contain 8 to 32 characters, including one numeric character, lowercase characters, uppercase characters, and one special character from the following character set:

! @ # $ % ^ & * ( ) ? _ < > " : ; ' , . /

User profile management 37


Do not use any of the following characters in a password:

• Leading or trailing spaces• Minus (-), plus (+), or equal (=)

The password is case sensitive.

4. Retype the password in the Confirm Password text box.

5. Click OK to commit the changes, or Cancel to close the Change Password dialog box without saving changes.

Changing email message settings

In the Edit Message Settings dialog box, you can change a user’s email message settings for the Framework and for Avamar extended retention.

1. In the My Profile springboard, select Change message settings.

The Edit Message Settings dialog box appears.

2. In the Edit Message Settings dialog box, select Framework or Avamar extended retention from the drop-down list.

3. Select one or more message types.

4. Repeat steps 2 and 3 to set message setting for the other component, or if finished, continue to step 5.

5. Click OK to commit the changes, or Cancel to close the Edit Message Settings dialog box without saving changes.



System configurationThis topic describes how to configure system settings and message settings in the Avamar Extended Retention Framework.

The Framework Configuration springboard

The Framework Configuration springboard configures the framework system settings and message settings.

This springboard contains two expandable and collapsible panels (represented by gray horizontal bars):

The Systems Settings panel includes settings for log levels, a session's timeout interval, and the maximum number of acknowledged events.

The Message Settings panel includes settings for email.

Clicking either panel expands or collapses its contents. The Framework Configuration springboard shows only one panel at a time.

Configuring system settings

System settings include log level, session timeout interval, and the maximum number of acknowledged events to retain in the events database.

1. In the Framework Configuration springboard, click the System Settings panel.

The System Setting panel opens.

2. In the Log Level list, select the level of logging for the framework:

• The Debug log level reports all types of system activities.

Setting the log level to Debug creates large log files. Use this level only when debugging problems with the framework.

• The Info log level reports informational messages only.

• The Warning log level (the default setting) reports conditions in the framework that might results in an operational failure.

• The Severe log level reports conditions in the framework for which an operation or component require immediate attention in order to continue working properly.

• The Critical log level reports conditions in the framework for which an operation or component has failed.

System configuration 39


3. For Session Timeout, select the amount of time before the framework logs out an inactive user. A session’s timeouts range from 1 to 9999 minutes with a default of 45 minutes.

No notification appears when a session times out; however, the user cannot interact with the framework's interface after it has timed out. If a session times out, the user must log back in to the Avamar Extended Retention framework.

4. For Max Ack. Events, select the number of acknowledged events to retain in the events database. The number of acknowledged events range from 100 to 9999 with a default of 2000.

If the number of acknowledged events exceeds the Max Ack. Events setting, the framework deletes the oldest events in the events database to manage the size of the events database.

5. Click Apply.

The Configuration dialog box appears.

6. Click OK.

Enabling and disabling message settings

Message settings configure email notifications using SMTP.

1. In the Framework Configuration springboard, click the Message Settings panel.

The Message Settings panel opens.

2. To enable the framework server to send email to users, select Enable Email.

The SMTP Server and From Email boxes appear.

3. In the SMTP Server box, type the Simple Mail Transfer Protocol (SMTP) server address.

The SMTP server address can be an IP address, a valid fully qualified name (FQN), or a Domain Name System (DNS) address.

You can type a maximum of 255 characters.

4. In the From Email box, type the email address in the standard email format:

[email protected]

The From Email box accepts a maximum of 255 characters.

5. Click Apply.

The Configuration dialog box appears.



6. Click OK.

You can also disable email notifications if preferred.

1. Clear the Enable Email checkbox.

2. Click Apply.

3. Click OK in the Framework Configuration message.

Enabling SNMP

Simple Network Management Protocol (SNMP) is an “Internet-standard protocol for managing devices on IP networks.” It is used mostly in network management systems to monitor network-attached devices for conditions that warrant administrative attention.1

In Avamar extended retention, any event that is visible in the Event Viewer will generate an SNMP trap. To configure SNMP, you must enable it in the Framework Configuration springboard, and then configure registered targets for the SNMP traps. See “Configuring SNMP traps” on page 117 for instructions on setting traps.

1. In the Framework Configuration springboard, click the Message Settings panel.

The Message Settings panel opens.

2. Select Enable SNMP.

3. Click Apply.

4. Click OK when you see the message that the configuration changes were successful.

1. en.wikipedia.org/wiki/Simple_Network_Management_Protocol#cite_note-ESNMP-0

System configuration 41


System eventsThis topic describes the Event Summary springboard and how to use the Event Viewer.

The Event Summary springboard

The Event Summary springboard provides a summary of system events and opens the framework Event Viewer. The Event Summary springboard and the framework Event Viewer automatically refresh their contents every 30 seconds.

The Event Summary springboard uses a heatpad to provide event notifications. The following figure illustrates the possible event colors.

The top bar shows event notifications. The heatpad distributes the events into four categories:

Red for critical event notifications. Orange for severe event notifications. Yellow for warning event notifications. Blue for informational event notifications.

Note: Acknowledged events do not appear in the totals.

When no unacknowledged events exist, the top bar contains the text, “0 Event Notifications,” and the bottom bar is solid blue and contains a 0 (zero).



Viewing event details in the Event Viewer

The Event Viewer provides system event details. To open the event viewer, click Launch Event Viewer in the Event Summary springboard. The Event Viewer lists only those events for which a user has roles to view.

The Event ViewerThe Event Viewer contains several columns that display details about the events.

The following table describes the columns in the Event Viewer.

Table 3 Event Viewer column descriptions

Column Description

Time The time the event occurred. Click the Time column heading to sort events by time. To alternate between ascending and descending order, click the Time column heading again.

Severity The severity of the event. Click the Severity column heading to sort events by severity. To alternate between ascending and descending alphabetical order, click the Severity column heading again.

System events 43


Note: You can resize the columns in the Event Viewer by clicking and dragging the vertical lines between the columns to the preferred width.

Updating eventsThe information in the Event Viewer updates when you:

Launch the Event Viewer. Click the Refresh event viewer icon . Add a filter.

By default, the information in the Event Viewer updates every 30 seconds.

Filtering eventsYou can filter the events that appear in the Event Viewer if you prefer to see only certain types of events.

1. In the upper-left corner of the Event Viewer, click the double-arrow button.

Message Event messages. Click the Message column heading to sort events alphabetically. To alternate between ascending and descending alphabetical order, click the Message column heading again.

Acknowledge Contains checkboxes. Click an event's checkbox to acknowledge the event. The event disappears from the Event Viewer.

Acknowledge Time

The date and time that the corresponding event was acknowledged. To see entries in this column, select the “Acknowledged” event filter or the “Both” event filter (see “Filtering events” on page 44).

Table 3 Event Viewer column descriptions

Column Description



The Event Filters panel expands.

2. Select the criteria that you want to use to filter the events.

The filter criteria in the Event Filter panel are described in the table following this procedure.

3. Under Date Range, if you select Between the following times:

a. In the From fields, click the calendar icon to select a date, and then click the down-arrow button to select a time.

b. Repeat these steps to set an end date and a time in the To fields.

4. Click Apply to apply the criteria you have chosen, or click Reset to restore the default settings.

Events appear in the Event Viewer based on the filter criteria.

System events 45


The following table describes the Event filter criteria.

Acknowledging eventsWhen you acknowledge an event, it no longer appears in the Event Viewer.

Do any of the following:

• To acknowledge a specific event, click the checkbox next to it in the Acknowledge column.

• To acknowledge all events, click Acknowledge All.

• To acknowledge only the events on the current page, click Acknowledge Events in Page.

Exporting events to a CSV fileYou can export system events in CSV format so that you can view them in an application that can display CSV files, such as Microsoft Excel.

1. Click Export to CSV.

2. In the Opening event.csv dialog box, select an application in which to open the file, or save the file.

Table 4 Event filter criteria panels

Panel Criteria

Severities Select one or more types: Critical lists critical events. Severe lists severe events. Warning lists warning messages. Informational lists informational messages.

Acknowledged Select a type of acknowledgment:• Un-acknowledged lists all unacknowledged events.• Acknowledged lists all acknowledged events.• Both lists both unacknowledged and acknowledged events.

Date Range Select a date range:• All lists all events.• Occurring within the last hour lists events within the last hour.• Occurring within the last day lists events within the last day (24 hours).• Between the following times lists events based on the selected beginning

and ending date and time.



The following figure shows an example CSV file opened in Microsoft Excel.

TasksThis topic describes the Task Summary springboard and how to use the Task Viewer.

The Task Summary springboard

The Task Summary springboard provides a summary of the number of tasks that users and by the framework's scheduler component are driving.

The Launch Task Viewer button opens the Task Viewer, which lists only tasks that a user can view, based on the user’s roles.

Viewing task details in the Task Viewer

The Task viewer provides task details. To open the Task Viewer, click Launch Task Viewer in the Task Summary springboard.

Tasks 47


The Task ViewerThe Task Viewer contains three icons and several columns that display task details.

The following table describes the columns in the Task Viewer.

Table 5 Task Viewer table column descriptions (Sheet 1 of 2)

Column Description

Type The icon that represents the corresponding task.

Name The task’s name. Click the Names column heading to sort tasks alphabetically. To alternate between ascending and descending alphabetical order, click the Names column heading again.

Description A short description of the task. Click the Description column heading to sort tasks alphabetically by the description. To alternate between ascending and descending alphabetical order, click the Description column heading again.

State The current state of the task. Possible states are:• Running• Completed• Failed• Scheduled• CanceledClick the State column heading to sort tasks alphabetically by state. To alternate between ascending and descending alphabetical order, click the State column heading again.

Start Time The date and the start time of a task shown in standard date and time format: yyyy-mm-dd hh:mm:ss.

End Time The date and the time a task completed. The framework uses the standard date and time format: yyyy-mm-dd hh:mm:ss.

Current Step Details about the current phase or step for the task.Click the Current Step column heading to sort tasks alphabetically by current step. To alternate between ascending and descending alphabetical order, click the Current Step column heading again.



Note: You can resize the columns in the Task Viewer by clicking and dragging the vertical lines between the columns to the preferred with.

Filtering tasksYou can filter the tasks in the Task Viewer if you prefer to see only certain types of tasks.

1. In the upper-left corner of the Task Viewer, click the double-arrow button.

The Task Filters panel expands.

2. Select the criteria that you want to use to filter the tasks.

Progress A color-coded bar that indicates the progress of active, canceled, or failed tasks:• Active tasks use a green progress bar.• Completed tasks use a blue progress bar.• Canceled and failed tasks use a red progress bar.

Action The action that is possible while the task is running.

Details Information icons for each task. To display the details for an individual task, click the icon in the task’s row. To display the details for every task, click the Show Details icon located above the Details column.

Table 5 Task Viewer table column descriptions (Sheet 2 of 2)

Column Description

Tasks 49


The filter criteria in the Task Filters panel are described in the table following this procedure.



b. Repeat these steps to set an end date and a time in the To fields.

4. Click Apply to apply the criteria you have chosen, or Reset to restore the default settings.

The Task Viewer lists tasks based on the filter criteria.

The following table describes the task filter criteria.

Security eventsSecurity events appear in the Security Events springboard and in the Security Event Viewer.

The Security Events springboard

The Security Events springboard uses color-coded graphics to indicate the current security threat level in the system.

The framework uses five colors to categorize threat levels:

Green for a low threat level Yellow for a medium threat level

Table 6 Task filter criteria

Panel Criteria

Task State Select one or more types of tasks to display: Running lists active tasks. Scheduled lists the scheduled tasks. Completed lists completed tasks. Canceled lists stopped tasks. Failed lists tasks that failed.

Date Range Specifies the date range:• All lists all tasks regardless of a date range.• Occurring within the last hour lists tasks that started within the last

hour.• Occurring within the last day lists tasks that started within the last day

(24 hours).• Between the following times lists tasks based on the selected

beginning and ending date and time.



Orange for a high threat level Red for a critical threat level Gray for an unknown threat level (the server may be down)

The current threat level is synonymous with the most critical security threat present in the system. For example, if 99 out of 100 security events are informational security events, and 1 is a critical security event, Avamar extended retention categorizes the threat level as high. The highest, or most critical event, determines the current threat level.

Viewing event details in the Security Event Viewer

The Security Event Viewer provides security event details. To open the viewer, click Launch Security Event Viewer in the Security Events springboard.

The Security Event ViewerThe Security Event Viewer contains icons and several columns that contain details about security events.

The following table describes the Security Event Viewer controls.

Table 7 Security Event Viewer controls

Click this button: To perform this task:

Update the contents on the page with new events that have occurred.

Archive selected security events.

Archive all security events.

Delete selected security events.

Delete all security events.

Clear the threat level.

Security events 51


The following table describes the columns in the Security Event Viewer.

Note: You can resize the columns in the Security Event Viewer by clicking and dragging the vertical lines between the columns to the preferred with.

Filtering security eventsYou can filter security events using several criteria.

1. In the upper-left corner of the Security Event Viewer, click the double-arrow button.

Table 8 Security Event Viewer column descriptions

Column Description

Time Lists the time the security event occurred. Click the Time column heading to sort security events by time. To alternate between ascending and descending order, click the Time column heading again.

Severity Lists severity icons and labels. Click the Severity column heading to sort security events by severity. To alternate between ascending and descending alphabetical order, click the Severity column heading again.

User Lists the user account associated with the security event.

Message Lists all security event messages. Click the Message column heading to sort security events alphabetically. To alternate between ascending and descending alphabetical order, click the Message column heading again.



The Event Filters panel expands.

2. Select the criteria that you want to use to filter the events.

The filter criteria in the Event Filters panel are described in the table following this procedure.



b. Repeat these steps to set an end date and an end time in the To fields.

4. Click Apply to apply the criteria you have chosen, or Reset to restore the default settings.

The Security Event Viewer shows events based on the filter criteria.

Security events 53


The following table describes the security event filter criteria.

Archiving security eventsYou can archive selected security events, or you can archive all events.

Security events are written to the SecurityArchive.xml file, which is located in a folder on the Media Access node. The directory location is specified by the <archiveLocation></archiveLocation> XML tags in the /opt/EMC/IMFsecuritylogger/config/SecurityLog.config file.

1. In the Security Event Viewer, select one or more security events that you want to archive.

Press and hold the control key to select multiple events.

2. Click Archive Events.

An informational dialog box appears.

3. In the dialog box, click Yes to archive the selected security events, or No to close the dialog box without archiving.

To archive all security events:

1. In the Security Event Viewer, click Archive All.


2. In the dialog box, click Yes to archive all of the security events, or No to close the dialog box without archiving.

Deleting security eventsYou can delete selected security events, or you can delete all of the events.

1. In the Security Event Viewer, select the security event(s) that you want to delete.

Press and hold the control key to select multiple events.

2. Click Delete Events.


Table 9 Security Event Viewer filter criteria

Panel Criteria

Severities Select one or more types of security events to display: Critical lists critical security events. Severe lists severe security events. Warning lists warning security messages. Informational lists informational security messages.

Date Range Specifies the date range:• All lists all security events regardless of a date range.• Occurring within the last hour lists security events within the last hour.• Occurring within the last day lists security events within the last day (24

hours).• Between the following times lists security events based on a beginning

and ending date and time.



3. In the dialog box, click Yes to delete the selected security events, or No to close the dialog box without deleting.

To delete all security events:

1. In the Security Event Viewer, click Delete All.


2. In the dialog box, click Yes to delete all security events, or No to close the dialog box without deleting events.

Clearing the security threat levelAfter you address security events, you can clear the threat level.

1. Click Clear Threat Level.

An information dialog box appears.

2. Click Yes to clear the threat level or No to close the dialog box, leaving the threat level as is.

Log informationThis topic describes the Log Information springboard, and describes how to view and save log.

The Log Information springboard

Only users with the Administrator role have access to the Log Information springboard.

The Log Information springboard enables you to:

Save log files. View a list of log files, and view details about the log files.

When you first notice a problem with the software, you can use the Log Information springboard to save the log file for that application. The save operation captures only the activity relevant to the specific time.

Log information 55


Viewing detailed log information

The Log Viewer contains detailed log information.

1. In the Log Information springboard, select a component, and click Launch Log Viewer.

2. In the Components panel, click the arrow next to the component name to display the hosts on which the component is running.

3. Select the host for which you want to see details. Information about the host and its logs appears in the Details panel.

The following table describes each column in the Details panel.

Saving log files

You can save a component’s log files to a folder that contains the current date in its name.

1. In the Log Information springboard, select a component.

2. Click Save Logs.

Table 10 Details panel column descriptions

Column Description

Host The fully qualified domain name of the host on which the component is running.

Key The column heading contained in the server database.

Value The value that corresponds to the Key.

Name The name of the log file.

Location The location of the log file.

Size The size of the log file.

Modified The date and timestamp that corresponds to the last time the log file changed.


CHAPTER 4Using the Avamar Extended Retention Workspace

The following topics describe how to use the Avamar Extended Retention workspace:

Opening Avamar Extended Retention springboards ................................................. 58 Managing library media .......................................................................................... 66 Exporting Avamar backups to tape .......................................................................... 86 Browsing and importing Avamar backups.............................................................. 105 Generating an import and export job history report ............................................... 112

Using the Avamar Extended Retention Workspace 57

Using the Avamar Extended Retention Workspace

Opening Avamar Extended Retention springboardsThe Avamar Extended Retention workspace provides several springboards that you use to perform different tasks. By default, the Import & Restore, Media Management, and Scheduled Exports springboards are already open when you access the workspace.

You can select other springboards that you want to appear in the Avamar Extended Retention workspace.

1. Click the TOOLBAR tab on the left side of the Avamar Extended Retention workspace.

The list of springboards appears.

2. Select the checkbox next to each springboard that you want to appear in the workspace.

3. After you have selected the springboards, click the TOOLBAR tab again to close it.

The following sections describe the springboards:

“The Media Management springboard” “The Scheduled Exports springboard” “The Import & Restore springboard” “The Configuration springboard”



“The Recent Events springboard” “The Task Monitoring springboard” “The Import & Export Job History springboard”

The Media Management springboard

The Media Management springboard contains the library that Avamar extended retentionis manages.

“Managing library media” on page 66 describes how to manage the library and the tape media.

The Scheduled Exports springboard

After you have set up the tape media, you can create export policies and begin using the Avamar extended retention feature to export Avamar backups to tape. You can create, manage, and run export policies on the Export Policy Management page, which opens when you click Configure Export Policies on the Scheduled Exports springboard.

The springboard also lists the export jobs that are scheduled to run in the next 24-hour period.

“Exporting Avamar backups to tape” on page 86 describes how to create and work with export policies.

Opening Avamar Extended Retention springboards 59


The Import & Restore springboard

After you have exported Avamar backups to tape, you can locate specific backups, and import them to the internal Avamar server on the Media Access node. You can also change the retention dates for backups as needed.

The Browse Exported Backups button on the Import & Restore springboard opens the Backup Browse/Import page, where you browse and import Avamar backups.

Optionally, on the springboard itself, you can filter backups by client name and date range before accessing the Backup Browse/Import page. Or, if you prefer, you can specify filter criteria after you access the page.

“Browsing and importing Avamar backups” on page 105 describes how to locate and import Avamar backups.

The Configuration springboard

The Configuration springboard displays information about the Avamar servers and the Media Access node. The Avamar Servers tab in the springboard displays the Avamar grids that are being used by the extended retention feature.



The Media Access node tab contains two sections: Import Server and System Properties. The Import Server section displays information about the Media Access node.

The System Properties section allows you to set the maximum number of jobs that can be run concurrently against the Avamar server. It also allows you to test EMC Call Home.



The Recent Events springboard

The Recent Events springboard lists the 20 most recent events that are associated with the Avamar Extended Retention’s Storage Management system, which manages the library and tape media.

The Recent Events springboard displays icons that indicate the severity of each event. The following table describes these icons.

The Launch Event Viewer button opens the Event Viewer, which contains all of the events in the system. To see the most recent events, go to the last page of the viewer.

Table 11 Event severity icons

Icon Description

Informational event.

Warning event.

Severe event.

Critical event.



Detailed information about the Event Viewer is provided in “System events” on page 42. You can also click the question mark icon in the upper right corner of the Event Viewer to access online help.



The Task Monitoring springboard

The Task Monitoring springboard displays Avamar extended retention tasks and their current states.

To filter the tasks by state, select a state in the Task State list. The possible task states include All, Scheduled, Running, Completed, Failed, and Canceled.

The Task Monitoring springboard displays icons that indicate the type and the state of each task. The following table describes the icons used to indicate task type.

The following table describes the icons used to indicate task state.

Table 12 Task type icons

Icon Description

A backup is being exported to tape.

A backup is being Imported from tape.

The Import server is being cleansed.

Table 13 Task state icons

Icon Description

The task has completed.

The task is scheduled.

The task is running.

The task was canceled.

The task failed.



The Launch Task Viewer button opens the Task Viewer, which displays all of the tasks. To see the most recent tasks, go to the last page of the viewer.

Click the Details icon to the right of a task to see information about it.

“Tasks” on page 47 provides detailed information about the Task Viewer. You can also click the question mark icon in the upper-right corner of the Task Viewer to open the online help.



The Import & Export Job History springboard

The Import & Export Job History springboard lets you generate a report for jobs of a specified type and state that have run within a certain date range.

Managing library mediaThis topic provides the following information:

“The Media Management page” “Working with custom tape pools” “Working with custom retention periods” “Labeling volumes” “Viewing library details” “Viewing the tape volumes in the library” “Viewing the backups on a tape volume” “Ejecting tape volumes” “Inventorying the contents of the library”

The Media Management page

You access the Media Management page by clicking Manage Export Media on the Media Management springboard in the Avamar Extended Retention workspace.



The Media Management page is shown in the following figure. This page is where you create and edit custom tape pools and retention periods, manage the library and drives, and label volumes for export and bootstrap purposes.

You should see only one library in the Avamar Extended Retention workspace.

If you need to add or remove a library drive after the system has been configured, you must contact EMC Professional Services.

Working with custom tape pools

Avamar Extended Retention uses tape pools to organize the volumes on which an export policy’s backups will be stored.

From the Media Management page, you can create custom tape pools that can be assigned to export policies. You can also edit and delete custom tape pools as necessary.

To create, edit, and delete custom tape pools, click the expand (+) button beside Pools in the Media Management page as shown here.

The Pools panel expands.

Managing library media 67


Two default system pools exist: Avamar Tape and Default. The Avamar Tape pool contains volumes that have not been assigned to another pool, and the Default pool contains bootstrap tapes. You cannot edit or delete the system pools.

Note: If the pools do not appear in the list, click Refresh.

Any custom tape pools that you create will also be listed in the Pools panel.

The following sections describe how to create, edit, and delete custom tape pools, and how to view the details of and the volumes contained in any pool.

Viewing the details of a tape poolTo view the details about a tape pool, select the pool in the list. The Pool Details panel opens underneath the list.



Viewing the volumes in a tape poolIn the Pools panel, select the pool whose volumes you want to see.

The volumes contained in the pool appear in the Volumes panel on the right-hand side of the Media Management page.

Creating a custom tape poolYou can create a custom tape pool, and assign it an existing custom or default retention period.

1. In the Pools panel, click Create Pool.

The Create Custom Tape Pool dialog box appears.

2. Type a name for the pool in the Name box.

Note: Pool names do not support the use of international characters. Use ASCII characters when naming a pool.

3. Leave the Enabled box checked if you want to be able to assign volumes to this pool.

4. Optionally, select a period in the Retention Period list.

You can use one of the default retention periods or a custom one that you have created. Instructions for creating custom retention periods are provided in “Working with custom retention periods” on page 72.



Note: The retention period that you assign to a pool takes precedence over any retention period that is defined for an export policy. Therefore, if you assign a pool to an export policy, the pool’s retention period will be used. Conversely, if the pool does not have a retention period, the export policy’s retention will be used.

5. Optionally, type some information about the pool in the Comment box.

6. Click Create Tape Pool.

7. Click OK when you see the Success message.

The new tape pool appears in the list of pools.

Editing a custom tape poolYou can edit the retention period and comments only for custom tape pools. You cannot edit the name of a pool, and you cannot edit the Avamar Tape and Default pools.

1. In the list of pools, select the pool that you want to edit, and click Edit Pool.



The Edit Tape Pool dialog box appears.

2. Modify the Retention Period and Comment entries as needed.

3. Click Edit Tape Pool.


Deleting a custom tape poolYou can delete only custom tape pools that do not contain any volumes. You cannot delete the Avamar Tape and Default pools.

1. In the list of pools, select the empty pool that you want to delete, and click Delete Pool.

2. Click Yes when you are asked to confirm the deletion.


The pool is removed from the list of tape pools.



Working with custom retention periods

Avamar Extended Retention uses retention periods to control how long the backups that have been exported to tape can be viewed, imported, and restored. Retention periods can be assigned to the backups that are specified in export policies and to custom tape pools.

Note: When a retention period lapses, the backups do not expire until you create a disaster recovery image. See “Creating a disaster recovery image” on page 132.

From the Media Management page, you can create custom retention periods that can be assigned to export policies and tape pools. You can delete custom retention periods as necessary.

To create and delete custom retention periods, click the expand/retract (+) button beside Retentions in the Media Management page as shown here.

The Retentions panel expands. Twelve default system retention periods exist by default, as shown in the following figure. You can assign these retention periods to custom tape pools and to export policies, but you cannot delete them.

Note: If the retention periods do not appear in the list, click Refresh.

Any custom retention periods that you create will also be listed in the Retentions panel.

The following sections describe how to view the details of any retention period, and how to create and delete custom retention periods.



Viewing the details of a retention periodTo view information about a retention period, select the retention in the list.

The Retention Details and Pools panels appear on the right-hand side of the Media Management page. The Retention Details panel provides details about the retention period, and the Pools panel provides information about the tape pools that use the retention period.

Creating a custom retention periodYou can create custom retention periods that you can apply to tape pools and to export policies.

1. In the Retentions panel, click Create Retention.



The Create Custom Retention Period dialog box appears.

2. Type a name for the retention period in the Name box.

3. Select a number and a duration in the Period lists.

4. Click Create Retention Period.


The new retention period appears in the list of retentions.



Deleting a custom retention periodYou can delete only custom retention periods that are not being used by a tape pool. You cannot delete any of the default system retention periods.

1. In the Retentions panel, select the custom retention period that you want to delete.

2. Click Delete Retention.

3. Click Yes when you are asked to confirm the deletion.


The retention period is removed from the list of retentions.

Labeling volumes

You must label the volumes in the library that you want to use as export tapes, and you must also label at least one volume as a bootstrap tape. The bootstrap tape is used for disaster recovery purposes.

Note: Labeling media takes time. The Event Viewer states that the labeling is queued; however, the amount of time required to label the media depends on the library’s current activity.

1. In the Media Management page, select the library in the Libraries panel.



Volumes in the library that have not been labeled are listed in the Volumes panel as unlabeled as shown in the following figure.

2. Click Label Media.



The Label Media dialog box appears. All of the volumes in the library that have not been labeled are listed.

3. In the Label Media dialog box, select the checkboxes beside the volumes that you want to label for export.

4. Under Label for export, select the tape pool in which you want the volumes to be contained.



Note: Instructions for creating tape pools are provided in “Working with custom tape pools” on page 67.



The Label Media dialog box closes, and the selected volumes are named using the corresponding barcode.

7. In the Media Management page, click Label Media again.

8. In the Label Media dialog box, select at least one volume that you want to use as a bootstrap tape.

Note: Bootstrap tapes are put into the Default tape pool, and are used to back up the media management and file databases. In the event you need to recover data, you can perform disaster recovery procedures using these tapes.

9. Select Label for bootstrap (“Default” pool), and then click Label Media.




Relabeling volumes to a different tape pool (not recommended)

The Label Media dialog box gives you the ability to relabel a volume into a different tape pool. However, if you do this, be aware of the negative consequences.

If you relabel a volume to a different tape pool, all non-expired backups on that volume will be removed. RELABELING VOLUMES IS NOT RECOMMENDED.



The Label Media dialog box appears. All of the volumes in the library that have not been labeled are listed.

3. In the Label Media dialog box, select Display all labeled and unlabeled volumes.

All volumes in the library are listed, and the Pool column appears. Volumes with an entry in the Pool column are labeled into the respective pool.

4. Select one or more volumes that you want to relabel.



5. Select the new pool in the Label for export list.


7. Click Yes when you see the first Relabeling Volume warning message.

8. Click Yes again to reconfirm your decision in the second warning message.




Viewing library details

To view details about the library, select the library in the Libraries panel. Information about the library appears in the Library Details panel as shown here.

The following table describes the Library details.

Table 14 Library Details panel columns

Detail Description

Name The name of the library, followed by the fully qualified domain name.

Type The type of library. Values can be NDMP, SILO, SCSI, UNKNOWN.

SCSI Address The library's SCSI address: SCSI bus, device ID, and Logical Unit Number respectively. If the library has a Type of Silo, SCSI Address is not shown.

Status The library's status: either ONLINE or OFFLINE.

Managed Indicates whether or not the library is being managed by Avamar extended retention: either true or false

Model The library's model.

Number of Devices The number of tape drives that the library has, the drives themselves, and the status of each drive.

Number of Import/Export Slots

The number of slots in the library that are used for importing and exporting Avamar backup data.



Viewing the tape volumes in the library

To view the tape volumes in the library, select the library in the Libraries panel. The tape volumes contained in that library appear in the Volumes panel.

The following table describes the columns in the Volumes panel.

Viewing the backups on a tape volume

The Show Backups button allows you to view the backups on a tape volume.

1. Select the library in the Libraries panel.

The volumes in the library are listed in the Volumes panel.

2. In the Volumes panel, select the volume whose backups you want to see.

Table 15 Volumes panel columns

Detail Description

Volume Name The name of the volume. Volumes that have not yet been associated with the Avamar Tape pool are designated as unlabeled. See “Labeling volumes” on page 75 for instructions on associating volumes with the pool.

Barcode The barcode of the tape volume.

Pool The tape pool to which the volume has been assigned.

Location The name of the library in which the volume is contained.

% Used The percentage of the volume that is being used.

Expiration The date the data on the volume expires.

Last Access Time The last time the volume was accessed.



3. Click Show Backups, located in the upper-right corner of the panel.

The Backups panel appears. It contains the backups that are on the selected volume.

The following table describes the columns in the Backups panel.

Table 16 Backups panel columns

Column Description

Backups The name of the backup.

Plug-In The file system running on the client from which the backup was created.

Volume(s) The volume or volumes on which the backup resides.

Client Name The name of the client from which the backup was created.

Avamar Grid The name of the Avamar Grid that created the backup.



Ejecting tape volumes

The Eject Tape(s) button allows you to eject one or more tapes from the library.

1. Select the library In the Libraries panel.

2. In the Volumes panel, select one or more volumes.

3. Click Eject Tape(s).

4. If at least one of the tapes that you are ejecting is labeled, you see the Eject Tape(s) dialog box shown in the following figure. Optionally, type a description of where the media will be stored after it is ejected, and then click Yes.

If the tapes that you are ejecting are not labeled, you see the following dialog box. Click Yes to eject the tape.

Note: If another tape is in the drive when you try to eject one or more tapes, the tapes that the you selected cannot be ejected. An error appears.

Backup Expiration The date and time the backup will expire.

Avamar Backup Date The date the backup was created by Avamar.

Export Timestamp The date and time the backup was exported to tape.

Table 16 Backups panel columns

Column Description



Inventorying the contents of the library

You can inventory the entire contents of the library, or you can inventory selected volumes. Each volume that you inventory is mounted to a free drive, its barcode is scanned, and its header is read. The inventory updates the Avamar extended retention database tables.

Note: In most instances, an inventory is not required. However, if you do have to inventory the library, make sure that the library is idle when the inventory takes place. If you try to inventory the library while the robot is busy performing an import or export, the inventory will fail.

The inventory process can take a long time. If the library has only one drive, no backups and restores can occur while the inventory is taking place.

1. Select the library in the Libraries panel.

2. Click Inventory.

The Inventory Library dialog box appears.



3. In the Inventory Library dialog box, do one of the following:

• Select Inventory entire library.

• Select Inventory the given slots, and then type the slot numbers in the box. Separate individual slots with commas, and use a dash to type a range of slots. For example:

3, 4, 6-9

Note: If you enter invalid slot numbers, you receive an error such as err.action.exception, server could not complete your request.

4. Click Inventory.

A progress bar appears.


Exporting Avamar backups to tapeThis topic provides the following information:

“The Export Policy Management page” “Creating an export policy” “Editing an export policy” “Activating or deactivating an export policy” “Deleting an export policy” “Performing on-demand exports” “Viewing export job details for active policies in the Task Viewer”

The Export Policy Management page

You access the Export Policy Management page by clicking Configure Export Policies on the Scheduled Exports springboard in the Avamar Extended Retention workspace.

On the Export Policy Management page, you can create and manage the export policies that run scheduled exports of Avamar backup data to tape; you can also perform on-demand exports.



The Export Policy Management page is shown in the following figure.

In the Export Policy Management page, you can:

View detailed information about the Avamar servers View the export policies that have been created for an Avamar server View export policy summaries View the clients that are associated with a specific export policy

Exporting Avamar backups to tape 87


Viewing details about an Avamar serverTo view the details about an Avamar server, select the server in the Avamar Servers panel. Information about the server appears beneath the panel.

The following table describes the Avamar server details.

Viewing the export policies for an Avamar serverYou can view all of the export policies that have been created for an Avamar server.

1. In the Avamar Servers panel, select the server for which you want to view the existing policies.

The export policies for that server are listed in the Export Policies panel.

2. Select a policy to view its summary.

3. To see the clients associated with the policy, select the policy, and then click Preview Policy Clients.

Table 17 Avamar Server details

Detail Description

Name The hostname of the server.

Total Capacity The total capacity of the server and the number of megabytes being used.

Status The status of the server. Statuses can be:FULL_ACCESS: The Avamar server is in its normal operating state.SUSPENDED: Normal operations have been suspended temporarily.ADMIN ONLY: The Avamar server is in an administrative state in which only the server or root user can read or write data.READ ONLY: The Avamar server is in a read-only administrative state in which all users can read data, but writing data is not allowed.

Server Version The Avamar software version running on the server.

IP Address The IP address of the Avamar server.



Viewing the summary of an export policyTo view the summary for an export policy, select the policy in the list. The Policy Summary panel opens from the right side of the page.

Viewing the clients included in an export policyThe Preview Policy Clients button allows you to view all of the clients that are included in an export policy.

1. Select a server in the Avamar Servers panel.

The export policies for that server are listed in the Export Policies panel.

2. Select a policy in the Export Policies panel.

3. Click Preview Policy Clients, located in the upper-right corner of the panel.

The All Avamar Clients Included in Policy dialog box opens. It lists all of the clients that are included in that export policy.



Creating an export policy

Export policies determine what plug-ins, domains, groups, and clients on an Avamar server are backed up, when they are backed up, and how long backups are kept.

Note: For Avamar extended retention systems that are attached to a library that has only one drive, exports that are started while an import is in progress will fail due to drive contention.

1. In the Avamar Servers panel, select the server for which you want to create the policy.

2. Click Create Policy.

The Create a New Export Policy wizard opens and displays the Policy Details screen, which is the first of five screens that you will use to create the policy.

The wizard screens include:

• Policy Details• Export Schedule• Avamar Client Filter• Avamar Backup Filter• Summary & Save



Configuring policy detailsIn the Policy Details screen, you configure a name for the export, and the backup retention period.

The Policy Details screen is shown in the following figure.

1. Make sure that the Active option is selected. This option should be selected by default.

Note: If you clear the Active option, the export policy cannot be run.

2. In the Policy Name box, type a name for the policy.

Note: Policy names must contain no more than 200 characters.

3. In the Pool Name list, select a tape pool. The backups in this policy will be exported to volumes that are in this pool.



If you select a pool that does not have a retention, the Backup Retention list appears, and you can optionally select a retention period for the policy.

4. Optionally, type a note about this policy.

5. Click Next.

The Export Schedule screen appears.

Configuring the export scheduleIn the Export Schedule screen, you configure the schedule on which exports will occur for this policy. You specify the frequency at which the schedule will run, and you configure detailed settings based on the selected frequency.

The Export Schedule screen is shown in the following figure.

Note: The export schedule that you create is based on the Avamar extended retention server time.



1. Select a Frequency option.

The frequency option that you select determines the configuration options that appear on the right side of the screen.

2. Configure the options for the selected frequency.

The following sections describe these options:

• “Regular intervals” on page 94 • “Specific weekdays” on page 94 • “Nth day of each month” on page 94 • “Specific date each month” on page 95• “On demand” on page 95

After you have configured the export frequency, the next five scheduled exports are shown in the lower panel of the Export Schedule screen.

3. Click Next.

The Avamar Client Filter screen appears.



Regular intervals

The Regular Intervals frequency lets you schedule the export to run at regular intervals; every specified number of days, weeks, or months. Selecting this frequency displays the configuration options shown in the following figure.

1. In the Run every lists, select a number and a time period.

2. In the at list, select the time of day that you want the schedule to run.

3. In the starting on box, click the calendar icon, and select a date.

Specific weekdays

The Specific Weekdays frequency lets you schedule the export to run on a specific day each week. Selecting this frequency displays the configuration options shown in the following figure.

1. Select a day beside Every.

2. In the at list, select the time of day that you want the schedule to run.


Nth day of each month

The Nth Day of each Month frequency lets you schedule the export to run on a specific weekday of each month. Selecting this frequency displays the configuration options shown in the following figure.

1. In the Run on the list, select a number.

2. Select a day of the week.

3. In the of each month, at box, select the time of day that you want the schedule to run.




Specific date each month

The Specific Date each Month frequency lets you schedule the export to run on a specific date each month. Selecting this frequency displays the configuration options shown in the following figure.

1. In the Run on the list, select a number.

2. In the of each month, at list, select the time of day that you want the schedule to run.


On demand

The On Demand frequency does not have configuration options.

Configuring the Avamar client filterIn the Avamar Client Filter screen, you select the domains, groups, and clients that will be included in this export policy.

The Avamar Client Filter screen is shown in the following figure.



1. Click Create/Edit Client Filter.

The Avamar Domains, Avamar Groups, and Avamar Clients panels expand from the left side of the screen as shown in the following figure.

2. In the Avamar Domains panel, select a domain.

When you select a domain, any client groups and clients that are associated with that domain appear in the Avamar Groups and Avamar Clients panels respectively.



3. To include a domain and its clients in the policy, click and drag the domain to the Included Avamar Domains panel.

Note: When you drag a domain to the Included Avamar Domains panel, its subdomains are not included in the export policy. You must drag each domain and subdomain separately as shown in the following figure.

When you include domains and subdomains in a policy by dragging them to the Included Avamar Domains panel, the clients in those domains and subdomains are also included in the policy.

4. In the Avamar Groups panel, select one or more groups (if they exist), and drag them to the Avamar Groups panel on the right.

When you select a group, all of the backups for the clients that belong to that group will be included in the export policy.

5. In the Avamar Clients panel, optionally select one or more clients, and drag them to the Explicit Avamar Clients panel.

Note: You can include specific clients in the policy even if you do not include the clients’ domain.

Clients in the Explicit Avamar Clients panel will be backed up even if they are removed from the selected domain or client group at some point in the future.

6. If you need to remove a domain, client group, or explicit client from the policy, select it in the respective panel on the right side of the screen, and drag it back to the corresponding panel on the left.

7. If you want to clear all of the selections and start over creating the client filter, click Clear Client Filter.



8. To see a summary of the selections, click Preview Client Filter.

The Preview Client Filter dialog box appears.

9. When you have finished creating the client filter, click Next.

The Avamar Backup Filter screen appears.



Configuring the Avamar backup filterIn the Avamar Backup Filter screen, you select the client backups that will be exported to tape when the policy runs. You can select to export only the most recent backup, or you can select a range of backups that will be exported to tape when the policy runs.

The Avamar Backup Filter screen is shown in the following figure.

1. In the Backup Types panel, select a backup type.

Note: Untagged backups are those that were run manually in Avamar.

2. If you want to export multiple backups rather than just the most recent one, after selecting the backup type, select Enable Multiple Backups in the Multiple Backups panel.

Select the number of hours prior to the most recent backup. All backups that occurred during the time between the most recent backup and the time specified will be included in this export policy.

Note: You must configure the multiple backup feature for any plug-in that requires multiple backups for a full restore. For example, you must do this for exporting and importing Oracle CLI database backups.

3. In the Avamar Plug-ins panel, select one of the options:

• Include backups for all Avamar plug-in types into the Export Policy. Select this option if you want to include all Avamar plug-ins that meet the filter criteria in this policy.



• Include only backups for the specific plug-in types into the Export Policy. Select this option if you want to include only backups from specific plug-ins. Then select one or more plug-ins in the Select Avamar Plug-Ins to Include panel, and drag them to the Included Avamar Plug-Ins panel. (Press and hold the Ctrl key to select multiple plug-ins.)

To remove a plug-in from the Included Avamar Plug-Ins panel, select the plug-in, and drag it back to the Select Avamar Plug-Ins to Include panel.

4. Click Next.

The Summary & Save screen appears.

Viewing the export policy's summaryThe Summary & Save screen provides a configuration summary of the export policy that you are creating.

The Summary & Save screen is shown in the following figure.

1. Review the export policy configuration.

2. If you need to make changes to the policy, navigate back through the Create a new Export Policy wizard using the Prev button or the bread crumbs located at the top of the screen (as shown in the following figure).



3. When you are satisfied with the export policy, click Finish & Save.

The Create a new Export Policy wizard closes, and the new policy is listed in the Export Policies panel on the Export Policy Management page.

Note: If the library drives are busy when an export is scheduled to run, the export will fail if a drive does not become available within 30 minutes. The failure appears in the Event Viewer. You must perform an on-demand export when a drive becomes available.

Editing an export policy

You can edit the export policies that you have created when you need to update policy details, export schedules, and Avamar backup and client filters.

Note: You must edit an export policy when changes that affect that policy have been made to the tree structure in the Avamar Administrator Management Console. Such changes can include moving clients, and changing, adding, or deleting groups and domains. These changes are not reflected dynamically in the Avamar extended retention user interface; therefore, you must update the policy manually to reflect these changes.

If you do not update the policy to match the changes in Avamar, the policy will fail when it tries to run.

1. In the Export Policies panel, select the policy that you want to edit.

2. Click Edit Policy.

3. The Editing 'policy_name' wizard opens on the policy's Summary & Save screen.

4. Navigate through the wizard using the Prev button or the bread crumbs located at the top of the screen (as shown in the following figure).

5. Edit the policy as needed, and then click Finish & Save.



Activating or deactivating an export policy

You can deactivate an export policy if you want to prevent if from running, but do not want to delete it. You can re-activate it later when you want it to resume its export schedule.

In the Export Policies panel, policy statuses appear in the Active column: “Yes” for currently active, and “No” for currently deactivated.

1. In the Avamar Servers panel, select the server for which you want to deactivate a policy.

The policies associated with that server appear in the Export Policies panel.

2. Select the policy that you want to activate or deactivate.

3. Click Activate/Deactivate Policy.

The Activate/Deactivate Policies dialog box opens.

4. In the Action list, select Activate or Deactivate, depending on what you want to do, and then click Save.

The policy’s Active status changes in the Active column.

Deleting an export policy

The Delete Policy button allows you to delete a selected export policy.

1. In the Avamar Servers panel, select the server for which you want to delete the policy.

The policies associated with that server appear in the Export Policies panel.

2. Select the policy that you want to delete.

3. Click Delete Policy.

4. Click Yes when you see the message asking you to confirm the deletion.



Performing on-demand exports

You can perform an on-demand export on a policy or on an individual client that is included in a policy.

An on-demand export request starts the export immediately unless the export policy is inactive or another export job is currently running. If another job is currently running, the on-demand export will run immediately after it has finished.

Performing policy on-demand exportsA policy must be active for an on-demand export to be performed. You cannot perform an on-demand export on a policy that is inactive.

1. In the Avamar Servers panel, select the server for which you want to perform the export.

The export policies that exist for that server are listed in the Export Policies panel.

2. In the Export Policies panel, select the policy for which you want to perform the export.

3. Make sure that the Active column for the policy contains Yes.

4. Click Perform On-Demand Export.

5. Click Yes when you see the message asking you to confirm the execution of the policy.

Performing client on-demand exportsThe policy that includes the client must be active for an on-demand export to be performed. You cannot perform an on-demand export for a client when the parent policy is inactive.

1. In the Avamar Servers panel, select the server for which you want to perform the export.

The export policies that exist for that server are listed in the Export Policies panel.

2. In the Export Policies panel, select the policy for which you want to perform the export.



3. Click Preview Policy Clients.

The Preview Clients for 'policy' dialog box appears.

4. In the Preview Clients dialog box, select the client for which you want to perform the on-demand export.

5. Click Perform On-Demand Export.

6. Click Yes in the confirmation message.

Viewing export job details for active policies in the Task Viewer

Once an export policy begins executing, it will show as running in Active state in the Task Monitoring springboard.

An export policy can contain multiple export jobs, some of which can run concurrently. The number of jobs that can run at the same time depends on the Maximum Parallel Jobs setting, which is described in “The Configuration springboard” on page 60.

In the Task Viewer, you can see details about how many jobs within the export policy are running, how many are waiting to run, and how many have completed.



1. Click Launch Task Viewer on the Task Monitoring springboard to open the Task Viewer.

2. Locate the running task, and click the Details icon next to the task to display information about it.

The information you see depends on the number of export jobs within the policy, and how many jobs can run concurrently. For example, if an export policy contains three export jobs and Maximum Parallel Jobs is set to 2, the task details might contain information similar to the following:

2 running, 1 waiting to run, 0 completed

In another example, if four policies are running at the same time and Maximum Parallel jobs is set to 2, the task details for two of the policies might contain information similar to the following:

1 Running, 0 waiting, 0 completed

The details for the remaining two policies might say something like this:

0 running, 1 waiting to be run, 0 completed

Browsing and importing Avamar backupsThis topic provides the following information:

“Restore limitations” “The Backup Browse/Import page” “Locating exported backups” “Importing backups from tape” “Editing backup retention periods” “Resetting the Import Server” “Restoring imported backups to a client”

Restore limitations

Avamar extended retention does not support the following Avamar advanced restore options:

Granular-level restore for:• Exchange• Microsoft Office SharePoint Server• Hyper-v

File-level restore for VMware image-level backups

Change block-based restores for:• Linux• VMware image-level backups

Multi-stream restore for:• Windows VSS Exchange• Hyper-v• Microsoft Office SharePoint Server

Sub-volume and Sub-database restores through the Avamar Management Console's “browse for restore” feature

Browsing and importing Avamar backups 105


The Backup Browse/Import page

You access the Backup Browse/Import page by clicking Browse Exported Backups on the Import & Restore springboard. If preferred, you can select a client and a date range in the springboard before you open the Backup Browse/Import page. If you do this, only that client’s backups that were exported during the selected date range will be listed in the Backup Browse/Import page.

On the Backup Browse/Import page, you can locate and restore the Avamar backups that have been exported to tape. You can also filter the backups by specifying a date range. The Backup Browse/Import page is shown in the following figure.

The panels in the Backup Browse/Import page are described as follows:

The Filter Clients panel lets you search for specific clients. You can type a client name if you know it, or you can use a wildcard character to list multiple clients. The clients that meet the criteria appear in the Avamar Clients panel.

The Import Server panel contains information about the Media Access node on which Avamar extended retention is running.



The Backup panel lists the backups that are associated with the selected client. “Customizing columns in the Backup panel” on page 110 provides instructions for customizing the columns that display and for sorting the information they contain in ascending and descending order.

The following table describes the columns in the Backup panel.

Locating exported backups

In the Backup Browse/Import page, you can view all the exported Avamar backups for the client that you select. You can also narrow down the list of Avamar backups by using several filter criteria.

1. In the Filter Clients panel in the Client Name box, type an asterisk (*) to list all clients, or type part of a client name using one or more asterisks as wildcard characters.

Note: If you type the entire client name and the system is unable to make a complete match, the client will not be listed in the Client Name panel. Using an asterisk in the search criteria is highly recommended.

Table 18 Backup panel columns

Column Description

Original Client The hostname of the client from which the backup was created.

Backup The name of the backup as it is known by Avamar extended retention.

Plug-In The type of file system running on the client from which the backup was created.

Volume(s) The volume or volumes in the library to which the backup was exported.

Size The size of the backup.

Pool The pool that contains the volume(s) on which the backup resides.

Policy The name and identifier of the export policy that initiated the backup.Backups that are associated with policies having the same name and identifier were exported together when the policy ran.For example, in the following figure, the backups that are associated with the first two policies in the list were exported together.

Avamar Grid The IP address of the Avamar grid on which the client was activated when it was backed up.

Backup Expiration The date and time the backup will expire.

Avamar Backup Date The date and time the backup was created by the Avamar server to which the client was activated.

Export TImestamp The date and time the backup was exported to tape by Avamar extended retention.



2. Press Enter or click Apply.

The clients that match the filter criteria appear in the Avamar Clients panel.

3. In the Avamar Clients panel, select the client whose backups you want to see.

The backups for that client appear in the Backup panel. By default, the list of backups contains those that were exported during the previous 3-month period.

4. If you want to see the backups that were exported during a different time frame, or if you want to use additional filter criteria, click Filter to display filter options.

5. Type and select the filter criteria, and then click Apply.

You can use an asterisk as a wildcard character when typing a Backup Name, an Original Client, a Policy Name, and a Grid Server Name.

Note: To remove the filter, click Clear, and then click Apply.

6. Browse through the backups to locate the backup(s) that you want to import.

Importing backups from tape

You can import a full backup or a partial backup, if available, from tape. Avamar extended retention retrieves the full or partial backup from tape, and imports it to the Avamar server that is installed on the Media Access node.

From there, you can restore it to a client as described in “Restoring imported backups to a client” on page 112.

Note: For Avamar extended retention systems that are attached to a library that has only one drive, an import that is started while an export is in progress will fail due to drive contention.

1. Locate the backup that you want to import as described in “Locating exported backups” on page 107.

2. In the Backup panel, select the backup, and click Import From Tape.



One of three possible Import From Tape dialog boxes opens.

• For backups that were exported using the latest version of Avamar Extended Retention, the following dialog box opens. These backups support partial imports. Select the item or items that you want to import, and then click Import.

Note: When you select a parent item in the tree structure, everything below it is automatically selected.

• For backups that were exported using the previous version of Avamar Extended Retention, the following dialog box opens. If you want to perform a partial import, click Build Partial Import File. If you want to import the entire backup, click Import.

• For backups that do not support partial imports, the following dialog box opens. Click Import to import the full backup.

3. Click OK, and then click OK again when you see the success message.

Note: If the library drives are busy when you request an import, the import will fail if a drive does not become available within 30 minutes. The failure appears in the Event Viewer, and you must resubmit the import request.



4. When the import has completed, use the instructions in “Restoring imported backups to a client” on page 112 to restore the backup to a client.

Customizing columns in the Backup panel

In the Backup panel, you can select the columns that you want to view. You can also sort the information in the columns in ascending or descending order.

Sorting in ascending or descending orderYou can sort the information in each column in ascending or in descending order.

1. Mouse over the name of a column in the Backup panel.

A down-arrow appears beside the name.

2. Click the down-arrow to display the menu.

3. Select a sort option in the menu.

Selecting columns to viewYou can select which columns you want to view in the Backup panel.

1. Mouse over the name of a column in the Backup panel.

A down-arrow appears beside the name.

2. Click the down-arrow to display the menu, and then click Columns.

The list of available columns appears.

3. Click the checkboxes beside the columns that you want to view.

4. Clear the checkboxes beside any column that you want to hide.



Editing backup retention periods

The backup retention period specifies how long backups that have been exported to tape will be kept. When you edit the backup retention period, you can select another retention period, or you can expire the backup now.

Note: If you choose to expire a backup now, the backup is marked as expired and is no longer visible in the Avamar Extended Retention interface. However, the backup still exists in the system until the next clean-up occurs (during the first 24 hours after you expire the backup).

1. Select one or more backups in the Backup panel. (Press and hold Shift to select a group of consecutive backups or Ctrl to select multiple non-consecutive backups.)

2. Click Edit Backup Retention.

The Edit backup Expiration Date dialog box appears.

3. If you want to configure a new backup retention period, select the Select a retention period from the drop down box option, then click the down-arrow and select a time period in the list.

4. If you want the backup to expire immediately, select the Expire now option. The backup will no longer be visible in the Avamar Extended Retention interface.

Resetting the Import Server

Periodically, you need to reset (or cleanse) the Avamar server that is installed on the Media Access node in order to make room for new imports. Resetting the server removes all previous backups that have been imported from tape.

1. Click Reset Import Server.

2. Click OK in the Reset Import Server confirmation message.



Note: You cannot cancel a reset request after you have submitted it.

Restoring imported backups to a client

After a backup has been imported, you must perform the following tasks to restore the backup to its original client or to another location:

Install the Avamar Administrator from the Media Access node's Avamar server on the machine you are using to perform backups and restores.

Identify the Avamar clients to which you are planning to restore backups, and activate them to the Media Access node's Avamar server.

Use the Avamar Administrator to restore the backups to a client.

Note: The EMC Avamar Administration Guide contains instructions for performing these tasks.

Generating an import and export job history reportFrom the Import & Export Job History springboard, you can generate a report that shows the import and export jobs that have run within the specified date range. The springboard is shown in the following figure.

You can generate a report that contains information about all import and export jobs that completed, failed, or were canceled, or you can filter the jobs by type and state before generating the report. You can also specify a date range for the jobs that are included in the report.

1. In the Import & Export Job History springboard, select a Job Type.

You can select Both (the default), to generate the report for both export and import jobs, or you can select Export or Import to generate the report only for the respective job type.

2. Select a Job State.



You can select All (the default) to generate the report for jobs that are in any state, or you can select Completed, Failed, or Canceled to generate the report only for jobs in the respective state.

3. If you want to filter the report by tape pool, select Filter Pool. Click the Pool Name text box to open the list of pools, and then select a pool.

4. Type a From: date and a To: date to specify the range of dates when the jobs ran.

The default range is today's date.

5. Click Generate Report to see the report immediately, or click Generate XML Report to create the report in XML format.

Generating an import and export job history report 113


The following figure shows part of an example Import and Export Job History report that was filtered for the AvamarTape pool.


CHAPTER 5Administration

The following topics describe the administrative tasks that you can perform for Avamar Extended Retention:

Customizing drop-down text in the login dialog box............................................... 116 Configuring the maximum value for parallel jobs ................................................... 116 Changing the root password on the Media Access node ........................................ 117 Configuring SNMP traps ........................................................................................ 117 Configuring the system to use an ACSLS library ..................................................... 123 Viewing current software versions ......................................................................... 127 Shutting down the Media Access node .................................................................. 127 Setting up a VMware vCenter client ....................................................................... 127

Administration 115

Administration

Customizing drop-down text in the login dialog boxIn the EMC Avamar Extended Retention login dialog box, you can customize the text that drops down when a user mouses over Warning: Authorized Users Only.

The customizable text is contained in the system.properties file.

To customize the drop-down text:

1. Change to the directory that contains the system.properties file:

cd /opt/EMC/IMF/apache-tomcat/catalina_base/imf/WEB-INF/classes/

2. Open the system.properties file in a text editor. For example:

vi system.properties

3. Beside user_message=, type the text that you want to display.

4. Save and close the file.

Configuring the maximum value for parallel jobsBy default, the maximum number of jobs that can run in parallel is set to 8. This value is selectable in the Configuration springboard's Media Access node tab under System Properties. (The Configuration springboard is in the Avamar Extended Retention workspace.)


Administration

To change the maximum value for parallel jobs:

1. Change to the directory that contains the system.properties file:

cd /opt/EMC/IMF/apache-tomcat/catalina_base/imf/WEB-INF/classes/

2. Open the system.properties file in a text editor. For example:

vi system.properties

3. Beside max_parallel=, type the maximum number.


Changing the root password on the Media Access nodeIf you want to change the root password on the Media Access node, you must use the change-passwords command. If you use another method, the cleanse function will no longer work correctly.

1. Log in to the Media Access node as root.

2. Change to the dpn user by entering the following command:

su dpn

3. Enter the following command:

change-passwords

4. Follow the prompts to change the password.

Configuring SNMP trapsTo use SNMP with Avamar extended retention, you must configure traps for the Avamar server and the tape management system running on the Media Access node.

In order for the SNMP management software to accept traps sent by the Media Access node, it must be configured to recognize the traps. Configuration procedures vary by the type of management software you are using.

For specific instructions on configuring the types of acceptable traps, refer to your SNMP management software documentation.

Configuring Avamar server traps

To configure Avamar server traps:


2. Change to the /opt/EMC/IMF/apache-tomcat/catalina_base/imf/WEB-INF/classes directory:

cd /opt/EMC/IMF/apache-tomcat/catalina_base/imf/WEB-INF/classes

Changing the root password on the Media Access node 117

Administration

3. Open the snmpTrapTargets.xml file in a text editor. The contents look like this:

<RegisteredTargets> <set>  </set></RegisteredTargets>

4. Edit the file so that it looks like the following example, where 10.10.10.10/162 is the address where the trap listener is running.

<RegisteredTargets> <set> <registeredTarget> <udpAddress> <UdpAddress>10.10.10.10/162</UdpAddress> </udpAddress> <trapApplications> <appToSeverity> <vaappName>Framework</vaappName> <severityLevels enumtype="com.emc.imf.core.model.Severity$ImfLevel"> INFO,WARN,SEVERE,CRITICAL</severityLevels> </appToSeverity> <appToSeverity> <vaappName>dto-app</vaappName> <severityLevels enumtype="com.emc.imf.core.model.Severity$ImfLevel"> INFO,WARN,SEVERE,CRITICAL</severityLevels> <appToSeverity> <vaappName>backupmgr</vaappName> <severityLevels enumtype="com.emc.imf.core.model.ifs.SeverityIf$ImfLevel"> INFO,WARN,SEVERE,CRITICAL</severityLevels> </appToSeverity> <appToSeverity> <vaappName>gridresourcemgr</vaappName> <severityLevels enumtype="com.emc.imf.core.model.ifs.SeverityIf$ImfLevel"> INFO,WARN,SEVERE,CRITICAL</severityLevels> </appToSeverity> </appToSeverity> </trapApplications> </registeredTarget> </set></RegisteredTargets>

5. Save and close the snmpTrapTargets.xml file.

Administration

Configuring tape management system traps

When Avamar Extended Retention has been installed, a configuration file, snmp-event.properties, is located in /opt/EMC/avamarer/config. This file contains instructions for configuring events and notification priorities. Default values have been set in the file, and you can modify it if you want different behavior.

You use the NWsnmp configuration utility, which is located in /opt/EMC/avamarer/bin/, to configure the tape management system running on the Media Access node to send event notification messages to the SNMP management software. Any changes you make to the snmp-event.properties file take effect when you run NWsnmp.

To configure tape management system traps:


2. If you want to view or modify the default SNMP behavior:

a. Change to the directory that contains the snmp-event.properties file:

cd /opt/EMC/avamarer/config

b. Open the file in a text editor. For example:

vi snmp-event.properties

The contents of the file are shown here.

## Copyright (C) 2012, All Rights Reserved, by EMC Corporation, Hopkinton, Mass.## This software is furnished under a license and may be used and copied only in# accordance with the terms of such license and with the inclusion of the above# copyright notice. This software or any other copies thereof may not be provided# or otherwise made available to any other person. No title to and ownership of the# software is hereby transferred.## The information in this software is subject to change without notice and should# not be construed as a commitment by EMC Corporation.## EMC Corporation assumes no responsibility for the use or reliability of its# software on equipment which is not supplied by EMC Corporation.#

### NOTE:# to enable any of the following Networker traps, change the "off" to "on"# to disable any of the following Networker traps, change the "on" to "off"## Once all the changes have been made run the NWsnmp command.##

# default is for the following to be enabled ( on ).snmp.event.media = onsnmp.event.server = onsnmp.event.device.cleaning.required = onsnmp.event.device.disabled = onsnmp.event.storage.node = onsnmp.event.media.request = onsnmp.event.device.disabled.2 = on

# default is for the following to be disabled ( off ).snmp.event.device.cleaned = offsnmp.event.cleaning.cartridge.required = off

Configuring SNMP traps 119

Administration

snmp.event.cleaning.cartridge.expired = offsnmp.event.media.capacity = offsnmp.event.netWorker.daemons = offsnmp.event.savegroup.failure = offsnmp.event.device.ordering.issue.detect = offsnmp.event.resource.file = offsnmp.event.savegroup = offsnmp.event.index = offsnmp.event.registration = offsnmp.event.bootstrap = offsnmp.event.license.expiration = offsnmp.event.client = offsnmp.event.bus.device.reset = offsnmp.event.deleted.media = offsnmp.event.write.completion = offsnmp.event.task.manager = offsnmp.event.hypervisor = off

# default enabled prioritiessnmp.priority.critical = onsnmp.priority.alert = onsnmp.priority.emergency = on

# default disabled prioritiessnmp.priority.info = offsnmp.priority.notice = offsnmp.priority.warning = offsnmp.priority.waiting = off

c. Make any necessary changes, and then save and close the file.

3. Change to the directory that contains the NWsnmp utility:

cd /opt/EMC/avamarer/bin/

4. Type the following command, and press Enter:

./NWsnmp [option...]

where option... can be one or more of the following:

--help

Print a usage message briefly summarizing command-line options.

--enable=[ yes | no ]

Enable or disable SNMP traps from the tape management system.

--priority=[ Info | Notice | Warning | Waiting | Critical | Alert | Emergency ]

The priority of the traps to forward.

--name=network_management_station_hostname

The host name of the server running the SNMP management software.

--server=media_access_node_hostname

The host name of the Media Access node.


Administration

The Management Information Base

The SNMP Management Information Base (MIB) that Avamar extended retention uses is provided below.

---------------------------------------------------------------------------- Copyright (c) 2005,2006 All rights reserved by---- EMC Corporation-- 171 South Street-- Hopkinton, MA 01748 USA ---- This software is furnished under a license and may be used and copied-- inclusion of the above copyright notice. This software or any other-- only in accordance with the terms of such license and with the-- copies thereof may not be provided or otherwise made available to any-- other person. No title to and ownership of the software is hereby-- transferred.---- The information in this software is subject to change without notice-- and should not be construed as a commitment by EMC Corporation.---- EMC Corporation assumes no responsibility for the use or reliability-- of this software.------------------------------------------------------------------------------ -- Author Identification---- SMC Shannon J Moyes Clark, EMC------------------------------------------------------------------------------------ 000 SMC 02-18-2009 Created Original Model------------------------------------------------------------------------------

EMCIMF-MIB

DEFINITIONS ::= BEGIN

IMPORTS enterprises FROM RFC1155-SMI OBJECT-TYPE FROM RFC-1212 TRAP-TYPE FROM RFC-1215; DisplayString FROM RFC1213-MIB MODULE-IDENTITY FROM SNMPv2-SMI

-------------------------------------------------------------Textual conventions for this MIB emc OBJECT IDENTIFIER ::= { enterprises 1139 }

IMF OBJECT IDENTIFIER ::= { emc 20 }--------------------------------------------------------------Groups in IMF

event OBJECT IDENTIFIER ::= {IMF 1}

imfComponent OBJECT IDENTIFIER ::={IMF 2} imfSeverity OBJECT IDENTIFIER ::={IMF 3}

Configuring SNMP traps 121

Administration

imfEventType OBJECT-TYPE SYNTAX DisplayString (SIZE (0..61)) ACCESS read-only STATUS mandatory DESCRIPTION "This is the textual value to define the event

type, as defined by all IMF Events. " ::= { event 1 }

eventTimestamp OBJECT-TYPE SYNTAX DisplayString (SIZE (0..100)) ACCESS read-only STATUS mandatory DESCRIPTION "Date event was reported" ::= { event 2 }

eventSummary OBJECT-TYPE SYNTAX DisplayString (SIZE (0..256)) ACCESS read-only STATUS mandatory DESCRIPTION "One summary description of event reported, English text only" ::= { event 3 }

isAcknowledged OBJECT-TYPE SYNTAX INTEGER { true(0), false(1), } ACCESS read-only STATUS optional DESCRIPTION "This value indicates if the event has been

acknoweldeged within in the IMF system. " ::= { event 4 }

acknowledgedTimestamp OBJECT-TYPE SYNTAX DisplayString (SIZE (0..100)) ACCESS read-only STATUS optional DESCRIPTION "The time that the event was acknoweldged within the IMF" ::= { event 5 }

componentName OBJECT-TYPESYNTAX DisplayString(SIZE (0..51))ACCESS read-only

STATUS mandatory DESCRIPTION "This is the name of the IMF Component. The

name must be unique accross the IMF System. " ::= { imfComponent 1 }

componentVersion OBJECT-TYPESYNTAX DisplayString(SIZE (0..51))ACCESS read-only

STATUS mandatory DESCRIPTION "This is the version of the IMF Component. " ::= { imfComponent 2 } componentType OBJECT-TYPE

SYNTAX INTEGER { IMFComponent(0),


Administration

IMFModule(1), IMFServive(2)

} ACCESS read-only STATUS optional DESCRIPTION "This is the component type as defined by the IMF." ::= { imfComponent 3 }

severity OBJECT-TYPE SYNTAX INTEGER { info(0), warning(1), severe(2), critical(3) } ACCESS read-only STATUS mandatory

DESCRIPTION "This is the severity of the event, as an enumeration." ::= { imfSeverity 1 }

severityText OBJECT-TYPESYNTAX DisplayString(SIZE (0..20))ACCESS read-only

STATUS mandatory DESCRIPTION "This is the severity of the event as a text

value. This should not be used for processing, but only for display as needed. Use the severityenumeration for any dependency processing.

" ::= { imfSeverity 2 }

-- Traps for IMF

imfEventTrap TRAP-TYPE ENTERPRISE IMF VARIABLES { imfEventType,

eventTimestamp, eventSummary, isAcknowledged, acknowledgedTimestamp, componentName, componentType,

componentVersion, severity, severityText } DESCRIPTION "An Imf event, which was generated by

the specified component and at the specified severity level. Any eventin the IMF defined to through SNMP traps, will default to this trap ifno other trap specifications are provided"

::= 1END

Configuring the system to use an ACSLS libraryThis section describes how to configure your Avamar Extended Retention system to use an ACSLS library.

Configuring the system to use an ACSLS library 123

Administration

Before you begin, verify that the tape drives are attached to the Media Access node via fibre optic cable. Also, ask your administrator to make sure that the drives are zoned for exclusive use by the Media Access node.

To configure your system:

1. Obtain the following information from your ACSLS administrator:

• ACSLS host name

• The number of physical tape drives to be configured for the ACSLS silo.

• ACSLS identifier (name) for all tape drives that have been partitioned for use by Avamar Extended Retention.

• The drive type(s)


3. Enter the following command to obtain the drive paths:

lsscsi

Example output is shown here. The lines that contain tape information are highlighted in bold:

[0:0:32:0] enclosu DP BACKPLANE 1.10 -[0:2:0:0] disk DELL PERC H700 2.10 /dev/sda[0:2:1:0] disk DELL PERC H700 2.10 /dev/sdb[0:2:2:0] disk DELL PERC H700 2.10 /dev/sdc[0:2:3:0] disk DELL PERC H700 2.10 /dev/sdd[0:2:4:0] disk DELL PERC H700 2.10 /dev/sde[0:2:5:0] disk DELL PERC H700 2.10 /dev/sdf[0:2:6:0] disk DELL PERC H700 2.10 /dev/sdg[1:0:0:0] mediumx STK SL500 1200 /dev/sch0[1:0:0:1] tape HP ULTRIUM 4-SCSI H44S /dev/st0[1:0:0:2] tape HP ULTRIUM 4-SCSI H44S /dev/st1

4. Look for "tape" in the enclosu column. In this example, the drive paths are /dev/st0 and /dev/st1.

There will be a tape entry with a path for every drive that is attached to the Media Access node.

5. Write down the drive paths, because you will be asked for this information during the configuration.

6. Enter the following command to configure the ACSLS library:

jbconfig

7. Respond to the prompts as follows:


Administration

Jbconfig is running on host media_access_node_hostname (Linux 2.6.32.12-0.7.1.3786.0.PTF-default), and is using media_access_node_hostname as the NetWorker server. 1) Configure an AlphaStor Library. 2) Configure an Autodetected SCSI Jukebox. 3) Configure an Autodetected NDMP SCSI Jukebox. 4) Configure an SJI Jukebox. 5) Configure an STL Silo. 6) Exit.which activity do you want to perform? [1]

Type 5, and press Enter.

Supported Silo types for this system are:1) ACSLS Silo (StorageTek)Enter the number corresponding to the type of silo you are installing:Choice?

Type 1, and press Enter.

Installing a StorageTek Silo.What name do you want to assign to this Silo device?

Type a name for the ACSLS silo device. You can use any name that you want.

Name of the host running the ACSLS software?

Type the ACSLS host name, and press Enter.

Pathname of the STL library for the ACSLS silo? [pathname]

Press Enter to accept the default pathname.

How many physical drives are to be configured for this silo (1 to 256)? [4]

Type the number of drives that are to be used by Avamar Extended Retention, and press Enter.

The drives in this jukebox cannot be auto-configured with the available information. You will need to provide the path for the drives.

Is (any path of) any drive intended for NDMP use? (yes / no) [no]

Press Enter to accept the default of no.

Is any drive going to have more than one path defined? (yes / no) [no]


Please enter the device path information in one of the following formats:/dev/nst0 --for local path orhost:device-path --for remote node or NDMP device(s) orhost:drive-letter:directory path --for Windows disk fileFor every device we configure, we're going to need the silo name as well as the path name(s). When you are done entering the system paths for a silo device, we will ask for the corresponding silo name. An example of the name we need for this type of silo is: 1,0,1,0Drive 1, element 1Drive path ?

Type the drive path, and press Enter.

Configuring the system to use an ACSLS library 125

Administration

Corresponding silo name value ?

Type the drive identifier given to you by the ACSLS administrator, and press Enter.

Please choose a model from the following types

A list of drive types appears. Locate the drive type in the list.

Enter the drive type of drive 1?

Type the number corresponding to the drive in the list, and press Enter.

Jukebox has been added successfully

The following configuration options have been set: > Silo software managed tape autocleaning on. > Barcode reading to on because this is a silo. > Volume labels that match the barcodes.You can review and change the characteristics of the autochanger and its associated devices using the NetWorker Management Console.Would you like to configure another jukebox? (yes/no) [no]


8. Open the /etc/init.d/networker script in a text editor; for example:

vi /etc/init.d/networker

9. Add the following lines above the start session:

export CSI_HOSTNAME='<acsls_hostname>'export SSI_HOSTNAME='<media_access_node_hostname>'

10. Add the following lines to the start session:

if [ -f /usr/sbin/ssi ]; then /usr/sbin/ssi > /nsr/logs/ssi.log 2>&1 & (echo ' ssi') > /dev/consolefiif [ -f /usr/sbin/mini_el ]; then /usr/sbin/mini_el -l /nsr/logs/mini_el.log 2>&1 & (echo ' mini_el') > /dev/consolefi

11. Add to the following lines to the stop session.

if [ -f /usr/sbin/ssi ]; then /usr/bin/pkill -9 ssi (echo ' ssi') > /dev/consolefiif [ -f /usr/sbin/mini_el ]; then /usr/bin/pkill -9 mini_el (echo ' mini_el') > /dev/consolefi

12. Save and close the networker script.

13. Restart the tape library management system by entering the following commands:

service networker stopservice networker start

14. Verify that the ACSLS library is ready to access commands:

nsrjb -C -j <acsls_name>

where acsls_name is the name of the silo device.


Administration

15. Look for the following message:

Jukebox acsls_name: (Ready to accept commands)

Note: It may take several minutes for the device to become "ready."

16. Allocate media to the ACSLS device using the following command:

nsrjb -a -j <acsls_name> -s <media_access_node_hostname> -T <media_identifier>

Viewing current software versionsTo view the current versions of all Avamar extended retention-related software:


2. Type the following command, and press Enter:

/opt/EMC/avamarer/bin/AERVersion

Shutting down the Media Access nodeIf you need to shut down the Media Access node for any reason, you must stop Avamar extended retention and the internal Avamar server instance first.

To stop Avamar extended retention and Avamar:


2. Stop Avamar extended retention by typing:

/opt/EMC/avamarer/bin/aerctl stop

3. Stop Avamar by typing:

/opt/EMC/avamarer/bin/dpnctl stop

4. Shut down the Media Access node.

Setting up a VMware vCenter clientThis section describes how to import VMware vCenter clients to the Media Access node. This procedure is necessary to enable Avamar extended retention to import VMware backups that have been exported to tape.

The instructions in this section assume that you have already configured and set up the VMware vCenter on an external Avamar grid and deployed virtual machine proxy clients. The EMC Avamar 7.0 for VMware User Guide provides instructions.

Setting up VMware vCenter clients for Avamar extended retention involves performing these steps on the Media Access node:

Modifying the mcserver.xml file Setting up the VMware vCenter client on the Media Access node

Viewing current software versions 127

Administration

Modifying the mcserver.xml file

Before you set up the VMware client, you must modify a setting in the mcserver.xml file on the Media Access node.

To modify the mcserver.xml file:


2. Change to the directory that contains the mcserver.xml file by typing:

cd /usr/local/avamar/var/mc/server_data/prefs

3. Open the mcserver.xml file in a text editor.

4. Locate the following line under <node name="vmware">:

<entry key="ignore_vc_cert" value="false" />

5. Change the value to "true".


7. Enter the following commands:

dpnctl stop mcsdpnctl start mcs

Setting up the VMware vCenter client on the Media Access node

These instructions describe how to create the VMware vCenter client on and import multiple clients to the Media Access node. You do this using the MCGUI on the Avamar server that is running on the Media Access node.

To set up a VMware vCenter client:

1. Log in to the Avamar MCGUI on the Media Access node.

2. Select Administration.

3. In the Account Management tab, right-click the root directory, and select New Client.

The New Client dialog box appears.


Administration

4. In the New Client dialog box, select VMware vCenter in the drop-down list.

The dialog box expands.

5. In the New Client Name or IP box, type the VMware vCenter’s fully qualified DNS name or IP address.

6. In the User Name box, type the VMware vCenter’s user name.

7. In the Password box, type the VMware vCenter’s password.

8. In the Verify Password box, retype the password.

9. Click OK.

Setting up a VMware vCenter client 129

Administration

10. In the client tree, right-click the vCenter server or a lower subdomain, and select Import Multiple Clients.

The Select Virtual Machine dialog box appears.

11. In the Virtual Machines tab, select Show sub-domain virtual machines to list the available virtual machines that the vCenter administers.

12. Select the virtual machines that you want to import to the Media Access node.

13. Click OK.

You can now use Avamar extended retention to import VMware backups that have been exported to tape. When you are ready to restore backups to a VMware proxy client, you must activate the client with the Avamar server on the Media Access node.


CHAPTER 6Disaster Recovery

The following topics describe how to create a disaster recovery image and how to recover the Avamar extended retention server in the event of a disaster:

Definition of a disaster .......................................................................................... 132 Creating a disaster recovery image ........................................................................ 132 Recovering the Avamar extended retention server ................................................. 133

Disaster Recovery 131

Disaster Recovery

Definition of a disasterA disaster is any situation in which the day-to-day access to data (for example, working files, software programs, or system files) is disrupted. A disaster also can damage network components, such as data, devices, hardware, media, and software.

A disaster can result from these situations:

Hardware and software failures

Infrastructure interruptions, inconsistencies, or loss of services, such as communication or network connections

The degree of loss during a disaster can range from one or more files to an entire computer system. The severity of the disaster determines the procedures necessary to recover data.

Creating a disaster recovery imageA recent disaster recovery image is necessary when recovering the Avamar extended retention server in the event of a disaster.

IMPORTANT

You should create a cron job to perform this procedure on a regular basis so that you always have a recent recovery image in case you need it.


2. Change to the disaster recovery directory:


3. Enter the following command to create the recovery image:

./avamar-er-dr --export --pass=<postgres_super_user_password>

This command creates a zip file containing the recovery image in the /opt/EMC/snapshot directory. The file name uses the following format:

[mmddyyyy-hhmmss]-avamar-er-dr-[Avamar-ER-Version#]-Snapshot.zip

For example:

12212012-115415-avamar-er-dr-1.0.0.0-Snapshot.zip

The example file was created December 21, 2012 at 11:54:15 am.

4. Copy this file to another system for safekeeping.


Disaster Recovery

Recovering the Avamar extended retention serverRecovering an Avamar extended retention server involves the following tasks:

“Install Avamar extended retention” on page 133 “Set up the lockbox password and the superuser account” on page 133 “Apply the Avamar extended retention disaster recovery image” on page 134 “Recover the bootstrap” on page 135

Install Avamar extended retention

Contact EMC Support to do the following:

1. Kickstart the Media Access node.

2. Install Avamar extended retention software on the Media Access node.

Set up the lockbox password and the superuser account

Use the following steps to set up the lockbox password and the superuser account.

1. Open a web browser and access the following URL:

https://media_access_node_IP_address:7443/imf.action

where media_access_node_IP_address is the IP address of the Media Access node on which the Avamar extended retention feature is running.

2. In the Setup Lockbox Password dialog box, type a lockbox password.

3. Type the password again to confirm it, and click Save Lockbox Changes.

The Create Framework Admin Account dialog box appears.

Recovering the Avamar extended retention server 133

Disaster Recovery

4. In the Create Framework Admin Account dialog box, type the name, email address, and password for the Avamar extended retention framework administrator account, suser.

5. Click Save Administrator Account.

The EMC Avamar Extended Retention login screen appears. You do not have to log in.

6. Apply the disaster recovery image as described in the next topic.

Do not label the media. Labeling media will result in data loss.

Apply the Avamar extended retention disaster recovery image

Applying the disaster recovery image performs a full recovery of the databases and configuration files.


2. Change to the disaster recovery directory:


3. Enter the following command to perform a full recovery from the disaster recovery image:

avamar-er-dr --import --pass=<postgres_super_user_password> --file=full_path_to_DR_image>

where full_path_to_DR_image is the path to the disaster recovery image that was created in “Creating a disaster recovery image” on page 132.

The command’s output is in the following format:

BOOTSTRAP: Most Recent bootstrap media barcode is <bootstrap_media_barcode>, Library name is <library_name>, device path is <device_path>, with bootstrap save set id <save_set_id>, created on <date_bootstrap_was_created>

For example:

BOOTSTRAP: Most Recent bootstrap media barcode is 000040, Library name is [email protected], device path is /dev/nst0, with bootstrap save set id 3859495220, created on Jan 9, 2012 12:00:04 PM


Disaster Recovery

4. Write down the bootstrap media details. You will need to use them when you recover the bootstrap.

Recover the bootstrap

Recovering the bootstrap overwrites the media database and recovers the resource files. Use the bootstrap media details that you captured to recover the bootstrap.

1. Mount the bootstrap media using the following command:

/usr/sbin/nsrjb -l -r -v -n -f <device_path> -T <bootstrap_media_barcode>

where device_path is the path name for the drive in which the bootstrap media will be loaded, and bootstrap_media_barcode is the media identifier.

2. Enter the following command to scan and recover the bootstrap media:

/usr/sbin/scanner -i -v <device_path>

where device_path is the path name for the drive in which the bootstrap volume is loaded.

3. Enter the following command to recover the database and resource files:

mmrecov

If the server has devices configured and enabled, the following prompt appears.

What is the name of the device you plan on using [device_path]?where device_path is the path name for the drive in which the bootstrap media is loaded.

4. At the following prompt, enter the save set ID that was displayed when you applied the disaster recovery image in the previous topic.

Enter the latest bootstrap save set ID []:

5. At the following prompt, press Enter to accept the default.

Enter starting file number (if known) [0]:

6. At the following prompt, press Enter to accept the default.

Enter starting record number (if known) [0]:

7. Stop Networker by typing:

service networker stop

8. Rename the res directory for the current installation by typing:

mv /nsr/res /nsr/res.orig

9. Rename the recovered res folder by typing:

mv /nsr/res.R /nsr/res

10. Restart Networker by typing:

service networker start


Recovering the Avamar extended retention server 135

Disaster Recovery

nsrck

Example output is shown below:

nsrck: checking index for 'host1.domain.com'nsrck: /DTO/nsr/index/host1.domain.com contains 13275 records occupying 3998 KBnsrck: checking index for 'host2.domain.com'nsrck: /DTO/nsr/index/host2.domain.com contains 0 records occupying 0 KBnsrck: Completed checking 2 client(s)

12. Verify that the export backups exist by typing:

mminfo -av


volume type client date time size ssid fl lvl name000039 LTO Ultrium-5 FQND 01/03/12 10:38:02 1734 MB 4228070705 cr manual DTO-1315425730@A4:BA000039 LTO Ultrium-5 FQND 01/03/12 13:36:18 1734 MB 4160972491 cr manual DTO-1315425730@A4:BA000040 LTO Ultrium-5 FQND 01/03/12 12:00:00 3637 KB 4211298415 cr full index:FQDN000040 LTO Ultrium-5 FQND 01/03/12 12:00:01 408 B 4194521199 cr full index:FQDN000040 LTO Ultrium-5 FQND 01/03/12 12:01:08 89 KB 4177743988 cr full bootstrap000040 LTO Ultrium-5 FQND 01/09/12 12:00:01 3637 KB 3876272433 cr full index:FQDN000040 LTO Ultrium-5 FQND 01/09/12 12:00:04 97 KB 3859495220 cr full bootstrap


CHAPTER 7Troubleshooting

The following topics describe how to troubleshoot issues that you may experience while using Avamar extended retention:

Modifying software components – caveats............................................................ 138 Import server issues.............................................................................................. 138 External Avamar server issues ............................................................................... 141 Import failures ...................................................................................................... 144 Export failures....................................................................................................... 146 Jobs take a long time to run................................................................................... 148 Library issues........................................................................................................ 148 A task failed or completed with exceptions............................................................ 150 The file index is reporting that it is full................................................................... 150 JavaScript errors.................................................................................................... 151 Timeout messages ................................................................................................ 151

Troubleshooting 137

Troubleshooting

Modifying software components – caveatsThe Avamar extended retention feature contains a number of components that enable you to export and import Avamar client backups to and from tape, and to restore them to an Avamar client.

IMPORTANT

Making unauthorized changes to any Avamar extended retention component will result in an unsupported configuration.

The following list states what you are and are not permitted to do when changing the configuration of any component.

You can use read-only operations against components to assist in diagnosing issues.

You must not make any changes to component configurations except:

• Through the Avamar extended retention user interface

• As documented by formal Avamar extended retention documentation or Technical Notes

• As directed by Avamar extended retention Support, Applications Engineering, or Engineering

You must not apply hot fixes, patches, or upgrades unless officially supported by Avamar extended retention.

Import server issuesThe Import server is the instance of the Avamar server that is running on the Media Access node.

The Import server does not display in the GUI

The Import server appears in the Avamar Extended Retention GUI in the following locations:

The Configuration springboard in the Media Access node tab The Task Monitoring springboard when tasks are scheduled, running, or completed In the Export Policy Management page The Import Server panel in the Backup Browse/Import page

If you do not see the Import server in the GUI, one of the following issues may be causing the problem.

The transport system service may be downIf the transport system service is down, you must restart the service.



ps -ef | grep Tran

Two processes should be running, with one the child of the other.


Troubleshooting

3. If the processes are not running, enter the following command:

service zzgridservice restart

4. Enter the following command again to make sure that the processes are running:

ps -ef | grep Tran

5. If the problem persists, check the grid service’s configuration as described in the following topic.

The transport system service may not be configured correctlyOnce you know that the transport system service is running, if you still cannot see the Import server in the GUI, the service may not be configured correctly.

1. On the Media Access node, open the following file in a text editor:

/opt/EMC/TransportSystemService/config/GridService.xml

An example GridService.xml file is shown here:

<NodeConfig> <com.emc.imf.service.common.ServiceConfig> <logLevel> <level>WARN</level> </logLevel> <brokerHostName>10.5.123.234</brokerHostName> <brokerport>61617</brokerport> <configFileName>/opt/EMC/TransportSystemService/config/ DefaultConfig</configFileName> </com.emc.imf.service.common.ServiceConfig></NodeConfig>

2. Verify that the <brokerHostName> element is set to the IP address of the Media Access node.

3. Verify that the <brokerport> element matches the port you assigned to Avamar extended retention when you installed it.


5. Restart the transport system service using the following command:


The MCS or GSAN may not be running on the external Avamar serverBoth the MCS and GSAN must be running on the external Avamar servers.

1. Log on to the external Avamar server as root.


dpnctl status

Import server issues 139

Troubleshooting

Example output is shown below. It shows the GSAN and MCS statuses as up.

Identity added: /home/dpn/.ssh/dpnid (/home/dpn/.ssh/dpnid)dpnctl: INFO: gsan status: updpnctl: INFO: MCS status: up.dpnctl: INFO: EMS status: down.dpnctl: INFO: Backup scheduler status: down.dpnctl: INFO: dtlt status: down.dpnctl: INFO: Maintenance windows scheduler status: suspended.dpnctl: INFO: Unattended startup status: enabled.dpnctl: INFO: [see log file "/usr/local/avamar/var/log/dpnctl.log"]

3. If either or both services are down, restart them.

The external Avamar server may not be running the supported build of AvamarThe external Avamar servers and the Media Access node must be running the same version of Avamar.

1. Log in to the Avamar server as root.

2. To see which version of Avamar is running, enter the following command:

avtar --version

Example output is shown below. In this example, the Avamar server version is 7.0.100-280.

version: 7.0.100-280build date: Feb 8 2013 21:34:29msg format: 13-10SSL: TLSv1 OpenSSL 0.9.8r-fips 8 Feb 2011Zlib: 1.2.3LZO: 1.08 Jul 12 2002platform: LinuxOS version: SLES-64Processor: x86_64

3. If the Avamar server version does not match the version running on the Media Access node, upgrade the server.

The Import server appears to be offline in the GUI

If the import server displays in the GUI as being offline, check the status of avdto and the GSAN.

The avdto process may be downIf the avtdo process is down, you must restart it.



ps -ef | grep avdto


Troubleshooting

If avdto is running, you will see output like the following:

root 1078 1023 0 14:56 pts/0 00:00:00 grep avdtoroot 7590 1 0 Mar01 ? 00:00:00 /usr/local/avamar/bin/dto/avdto.bin --vardir=/usr/local/avamar/var/dto --bindir=/usr/local/avamar/bin/dto --vardir=/usr/local/avamar/var/dto --daemon --logfile=/usr/local/avamar/var/dto/avdto_daemon.log

3. If avdto is not running, enter the following command:

service avdto start

The GSAN may have failed on the Media Access nodeIf the GSAN has gone down, you must reset the import server.


2. Enter the following command to determine the status of the GSAN:

dpnctl status



3. If the GSAN is down, reset the import server as follows:

a. In the Avamar Extended Retention workspace, click Browse Exported Backups on the Import & Restore springboard.

b. In the Backup Browse/Import page, click Reset Import Server.

c. Click OK when you see the Reset Import Server message.

External Avamar server issuesThe following issues are specific to the external Avamar servers whose backups are being exported by the Avamar extended retention system.

Note: These Avamar servers are referred to as “external” to distinguish them from the Avamar server that is running on the Media Access node.

Avamar servers incorrectly appear offline in the GUI

Synchronize the clocks between the external Avamar servers and the Media Access node.

External Avamar server issues 141

Troubleshooting

Avamar servers do not appear in the GUI

The external Avamar grids appear in the Avamar Extended Retention GUI in the following locations:

The Configuration springboard in the Avamar Servers tab The Task Monitoring springboard when tasks are scheduled, running, or completed In the Export Policy Management page

If you do not see the Avamar servers in the GUI, one of the following issues may be causing the problem.

The transport system service may be downIf the transport system service is down, you must restart it.

1. Log in to the external Avamar server as root.

2. Enter the following command to determine if the transport system services are running:

ps -ef | grep Tran

Two processes should be running, one being the child of the other.

3. If the processes are not running, enter the following command:


4. Enter the following command again to make sure that the processes are running:

ps -ef | grep Tran

5. Repeat this process on each of the external Avamar servers.

6. If the problem persists, check the grid service’s configuration as described in the following topic.

The transport system service may not be configured correctlyOnce you know that the transport system service is running, if you still cannot see the external Avamar servers in the GUI, you may have miss-configured the service, causing it not to communicate with the Media Access node.

1. On the Avamar server, open the following file in a text editor:

/opt/EMC/TransportSystemService/config/GridService.xml

An example GridService.xml file is shown here:

<NodeConfig> <com.emc.imf.service.common.ServiceConfig> <logLevel> <level>WARN</level> </logLevel> <brokerHostName>10.5.123.234</brokerHostName> <brokerport>61617</brokerport> <configFileName>/opt/EMC/TransportSystemService/config/ DefaultConfig</configFileName> </com.emc.imf.service.common.ServiceConfig></NodeConfig>


Troubleshooting

2. Verify that the <brokerHostName> element is set to the IP address of the Media Access node.

3. Verify that the <brokerport> element matches the port you assigned to Avamar extended retention when you installed it.


5. Restart the transport system service using the following command:


The MCS or GSAN may not be running on the external Avamar serverBoth the MCS and GSAN must be running on the external Avamar servers.

1. Log on to the external Avamar server as root.


dpnctl status

Example output is shown below. It shows the GSAN and MCS status as up.


3. If either or both services are down, restart them.

The external Avamar server may not be running the supported build of AvamarThe external Avamar servers and the Media Access node must be running the same version of Avamar.

1. Log in to the Avamar server as root.

2. To see which version of Avamar is running, enter the following command:

avtar --version

Example output is shown below. In this example, the Avamar server version is 7.0.100-280.

version: 7.0.100-280build date: Feb 8 2013 21:34:29msg format: 13-10SSL: TLSv1 OpenSSL 0.9.8r-fips 8 Feb 2011Zlib: 1.2.3LZO: 1.08 Jul 12 2002platform: LinuxOS version: SLES-64Processor: x86_64

3. If the Avamar server version does not match the version running on the Media Access node, upgrade the server.

External Avamar server issues 143

Troubleshooting

Avamar server performance is affected by extended retention activities

If the performance of the external Avamar servers is being affected negatively by Avamar extended retention activities, try reducing the number of jobs that are running in parallel.

1. Log into the Avamar Extended Retention GUI.

2. Access the Avamar Extended Retention workspace.

3. In the Configuration springboard, click the Media Access node tab.

4. Click System Properties.

5. Select a lower number for the Maximum Parallel Jobs setting, and click Apply.

Import failuresThe following topics describe possible import failure scenarios.

Import failed and did not display in the Avamar MC Activity Monitor

Try the following:

Make sure the MCS and GSAN are running on the Media Access node.

Make sure the avagent is running and configured for the Media Access node to itself.

Check that the extended retention client (avagent) is running and in the avagent log, it has the 1024 and 1034 plug-ins registered.

Check that each avagent on the Media Access node is on a separate port.

Import failed and can be seen in the Import server's Avamar MC

Try the following:

Make sure that the avdto process on the Media Access node is running. To do this:

a. Log in to the Media Access node as root.

b. Enter the following command:

ps -ef | grep avdto

If it is running, you will see output like the following:

root 1078 1023 0 14:56 pts/0 00:00:00 grep avdtoroot 7590 1 0 Mar01 ? 00:00:00/usr/local/avamar/bin/dto/avdto.bin--vardir=/usr/local/avamar/var/dto--bindir=/usr/local/avamar/bin/dto--vardir=/usr/local/avamar/var/dto --daemon--logfile=/usr/local/avamar/var/dto/avdto_daemon.log

c. If it is not running, enter the following command:

service avdto start

Check the Event Viewer for events that might provide more information.

Make sure that imports are not trying to run while the library drives are being used for exports.


Troubleshooting

Backups do not appear in the Backup Browse/Import page

Determine whether any backups have been exported to tape.


2. Run the following command to verify that the backup exists:

mminfo -av

If no backups appear, they have not been exported to tape.

An Avamar client does not appear in the Backup Browse/ Import page

If you do not see an Avamar client in the Backup Browse/Import page, the following sections may provide information about what is causing the problem.

Avamar clients in generalSometimes, the Avamar server on the Media Access node cannot create a client during an export operation due to nslookup issues; in other words, the server cannot “see” the client for which it is exporting the backup. When this happens, the backup is still exported to tape, but it will be “archived” under the Media Access node client itself. When you select that backup and restore it, the system restores the original client that could not be created because of the lookup issues.

To avoid this problem, make sure that the DNS or the /etc/hosts file on the Media Access node has been configured to “see” all of the clients that are being backed up by the external Avamar servers.

Note: If you create a backup on a client that is using an alias that is not DNS resolvable, the client backup will be exported, but it will show up under the Avamar Extended Retention client name rather than under is own name.

Celerra NDMP clientsFor Celerra NDMP clients, when you configure an Avamar Accelerator node to be part of the Avamar extended retention environment, you are prompted to enter a name that will be used to register the NDMP client with Avamar. This client name must be the fully qualified domain name of the Data Mover, which in this case is the Media Access node.

The configuration prompts are shown below:

Choose an action: 1. Add a new system 2. Edit an existing system 3. Remove a system from the list 4. Exit setupEnter action: [4]: 1Setting up a new system account

What kind of system do you want to setup? 1. EMC Celerra 2. NetApp FilerEnter choice: 1Starting setup for EMC CelerraNetwork address or DNS name of the EMC Celerra [filer.company.com]:hostname.example.com

The ndmp user password on "hostname.example.com":Repeat password:

Import failures 145

Troubleshooting

Password encoding scheme ("md5" or "text") to use for "hostname.example.com" [md5]:

Checking username and password... avndmp returning with exitcode 0verifiedAvamar account name for "hostname.example.com" [hostname.example.com]:

Export failuresThe sections in this topic describe possible export failure scenarios.

Exports are failing in general

Make sure that the Avamar extended retention client has been registered with the internal and external Avamar servers.


2. Change to the /data01/avamar/var/dto directory:

cd /data01/avamar/var/dto

3. List the contents of the directory:

ls -al

For each server with which the Avamar extended retention client was registered, including the instance of Avamar that is running on the Media Access node, you should see a directory named with the following format:

AvamarServerIPAddress-MediaAccessNode

where MediaAccessNode can be the FQDN or IP address of the Media Access node.

Example output is shown here:

drwxr-xr-x 2 root root 4096 Feb 7 10.5.123.234-MediaAccessNode.example.comdrwxr-xr-x 2 root root 4096 Feb 7 10.5.160.185-10.5.160.195drwxr-xr-x 2 root root 4096 Feb 7 10.5.170.165-MediaAccessNode.example.com

If the internal Avamar server or an external Avamar server is missing from the list, you must register the Avamar extended retention client with that server:

1. Make sure that you are still logged in to the Media Access node as root.


/user/local/avamar/bin/dto/avmultiregister.pl

3. The following output appears:

=== DTO Registration and Activation ===---------------------------------------This script will register and activate the DTO plugin with the Avamar Administrator server.Agent status(es):-----------------=== DTO Registration and Activation ===---------------------------------------1. Register to a new server2. Remove a current registration3. Show current agent status4. ExitYour choice:


Troubleshooting

4. Enter 1, and then respond to the prompts to register the client with the Avamar server.

Exports do not appear in the Avamar MC and fail in extended retention

Try the following:

Make sure that the Media Access node is registered as a client with the external Avamar servers as described in “Exports are failing in general” on page 146.

Make sure that the MCS and GSAN are running on the external Avamar server as described in “The MCS or GSAN may not be running on the external Avamar server” on page 139.

Check that the avagents are running. To do this, enter the following command:

ps -ef | grep avagent

You should see output like the following:

root 692 1 0 Feb29 ? 00:00:01 /usr/local/avamar/bin/dto/avagent.bin--bindir="/usr/local/avamar/bin/dto" --sysdir="/usr/local/avamar/etc"--flagfile="/usr/local/avamar/etc/agentsettings.cfg"--vardir="/data01/avamar/var/dto/10.5.150.246-host3219.example.com"--logfile="/data01/avamar/var/dto/10.5.150.246-host3219.example.com/avagent.log"--listenport=28004

root 810 1 0 Feb29 ? 00:00:00 /usr/local/avamar/bin/dto/avagent.bin--bindir="/usr/local/avamar/bin/dto" --sysdir="/usr/local/avamar/etc"--flagfile="/usr/local/avamar/etc/agentsettings.cfg"--vardir="/data01/avamar/var/dto/10.5.150.247-host3219.example.com"--logfile="/data01/avamar/var/dto/10.5.150.247-host3219.example.com/avagent.log"--listenport=28005

root 7733 1 0 Mar01 ? 00:00:01 /usr/local/avamar/bin/dto/avagent.bin--bindir="/usr/local/avamar/bin/dto" --sysdir="/usr/local/avamar/etc"--flagfile="/usr/local/avamar/etc/agentsettings.cfg"--vardir="/data01/avamar/var/dto/10.5.139.219-host3219.example.com"--logfile="/data01/avamar/var/dto/10.5.139.219-host3219.example.com/avagent.log"--listenport=28003

Make sure that each avagent on the Media Access node is on a separate port. The --listenport setting in the ps output displays the port.

Make sure that the Avamar extended retention client (avagent) is running and in the avagent log. The --logfile setting in the ps output displays the log location. The log should indicate that plugins 1034 and 1024 have been registered successfully. For example:

2012-03-05 14:19:28 avagent Info <7502>: Registration of client /clients/host3219.example.com with MCS 10.5.123.219:28001 successful.2012-03-05 14:19:28 avagent Info <5928>: Registration of plugin 1034 Unix successful.2012-03-05 14:19:28 avagent Info <5928>: Registration of plugin 1024 dto successful.2012-03-05 14:19:28 avagent Info <5619>: Registration of client and plugins complete.

Export failures 147

Troubleshooting

An export failed and appears in the MC Activity Monitor

Do the following:

Follow standard troubleshooting for all Avamar plug-ins.

If you have a single drive, make sure that an import is not running at the same time as the export. Try the export again when the drive is available.

Not all exports were written to tape, but the export task completed

Do the following:

Check the Event viewer to see if a client was skipped because it did not match the policy.

Check the Avamar MC to confirm that a backup is found within the rules of the policy.

The Event Viewer indicates that an export event was skipped

Try performing an on-demand export of the backup that was not exported.

An export worked but the client is not in the import list

If the Media Access node cannot resolve the host name for a given client, it will:

Create a user event indicating that it cannot resolve the client. Store the backup under the extended retention client.

You can do one or both of the following:

Look for the backup under the extended retention client. Add the client to the network lookup for the Media Access node.

Jobs take a long time to runCommunication may have failed between the Avamar MC and Avamar extended retention. The job may have actually completed, but Avamar extended retention still shows it as running.

Library issuesThe following issues pertain to the tape library attached to the Media Access node.

The library does not appear in the GUI

The library that is used by Avamar extended retention must not be shared. It must be zoned for exclusive use by the Media Access node, and the robot must be controlled only by Avamar extended retention.


2. Change to the /opt/EMC/scsilibdetector/bin/ directory:

cd /opt/EMC/scsilibdetector/bin/


Troubleshooting


./scsilibdetector

You should see information similar to the following for the library:

Vendor: IBM Version: A.50 SCSI ID: 2.0.1 Slots ( Storage: 44 Import/Export: 3 Drives: 2 )

4. If the library is detected, wait for it to display in the GUI.

5. If the library is not detected, do the following:

• Check the fiber connection between the Media Access node and the library• Ask the IT department to check the zoning• Restart the Media Access node

The library appears as UNKNOWN in the GUI

If the library is shown as UNKNOWN in the Media Management springboard, Avamar extended retention was not able to configure it automatically.

Configure the library manually.

1. On the Media Management springboard, click Manage Export Media.

The Media Management page opens.


3. Click Configure.

The Configure Library dialog box appears.

4. In the Configure Library dialog box, click Configure Library.

A progress bar appears.


Library issues 149

Troubleshooting

After you configure the library, it should appear in the Libraries panel like the one shown here.

An eject tape request failed

Do the following:



nsr_render_log -l -S 24 /nsr/logs/daemon.raw

3. Look for errors that explain why the eject failed

A task failed or completed with exceptionsDo the following:



nsr_render_log -l -S 24 /nsr/logs/daemon.raw

3. Look for errors that explain why the task failed.

The file index is reporting that it is fullThe Media Access node’s Avamar server disk is getting full. You need to change the secondary retention period for one or more backups.

1. Log in to Avamar Extended Retention, and access the Avamar Extended Retention workspace.

2. On the Import & Restore springboard, click Browse Exported Backups to open the Backup Browse/Import page.

3. In the Filter Clients panel, type * in the Client Name box, and then click Apply.

4. Select a client in the Avamar Clients panel to display the backups for that client in the Backup panel.

5. Select one or more backups in the Backup panel.

6. Click Edit Secondary Retention.


Troubleshooting

The Edit Secondary Retention Period dialog box appears.

7. In the Edit Secondary Retention Period dialog box, select a shorter retention period, or select to expire the retention period now, and then click Save.

JavaScript errorsIf you get a Java script error, try refreshing the browser. If that does not work, try restarting the browser.

Timeout messagesIf you receive a timeout message while trying to perform a task, refresh the browser, and then retry the operation.

JavaScript errors 151

Troubleshooting


Revised: June 18, 2013 11:39 am

INDEX

Aaccounts

being locked out of 20creating 30disabling 32editing 31role types 34unlocking 33

ACSLS library configuration 123Administration workspace 20

definition of 21springboards

Event Summary 42Framework Configuration 39Log Information 55My Profile 36Role Management 33Security Events 50Task Summary 47User Management 30

using 29, 115archiving security events 54Avamar backups

browsing and importing 105exporting to tape 86filtering 99

for all Avamar plug-ins 99for most recent backup 99for multiple backups 99for specific Avamar plug-ins 100

Avamar client filters 95Avamar extended retention

capabilities and limitations 13important terms and definitions 14introduction to 11logging in to 18, 133logging out of 27springboards

Configuration 60Import & Export Job History 66, 112Import & Restore 60Media Management 59opening 58Recent Events 62Scheduled Exports 59Task Monitoring 64

user name, suser 19workspace

accessing 23description of 21using 57

Avamar serverexternal 14import 14

troubleshooting external 141troubleshooting import 138viewing export policies for 88viewing status of 60

BBackup Browse/Import page 106

sorting information in Backup panel 110backups

definition of 14deleting from the import server 111exporting most recent 99exporting multiple 99filtering 99

for all Avamar plug-ins 99for most recent 99for multiple 99for specific Avamar plug-ins 100

full 108importing from tape 108locating for import 107metadata 14partial 108performing on-demand exports for 103restoring to a client 112retention periods

editing 111setting 91

selecting columns to view in Backup panel 110sorting information in columns 110viewing

on a tape volume 82best practices

clear browser cache before first login 16create administrative user account 15create disaster recovery image 16label bootstrap tapes 16operational 15synchronize backup creation and export 15

bootstrap tapeslabeling 75, 78

bootstrap, recovering 135Browse/Import page

customizing columns in Backup panel 110browsers supported by Avamar extended retention 18

Ccapabilities and limitations 13client filters 95clients

locating for import 107performing on-demand exports for 103viewing those included in an export policy 89

Index 153


Index

Configuration springboard 60configuring

Avamar backup filters 99Avamar client filters 95export policies 90export policy details 91export schedules 92log level 39message settings 40, 41session timeout 40SNMP 41system settings 39the system 39

copying springboards to My Workspace 24CSV files

exporting system events to 46

Ddefinitions and terms 14deleting

backups from the import server 111export policies 102security events 54

disaster recoveryapplying a recovery image 134creating a recovery image 132image 16

Eediting

backup retention periods 111email address in user profile 37Springboards list in My Workspace 24user account 31

ejecting tape volumes 84email

disabling message settings 41editing address 37editing message settings 38enabling message settings 40

Event Summary springboard 42Event Viewer 43, 62

exporting events in CSV format 46updating the events table 44

eventssecurity 50

archiving 54clearing the security threat level 55deleting 54viewing in the Security Event Viewer 51

system 42exporting in CSV format 46updating 44viewing details in the Event Viewer 43

exportclients, on-demand for clients 103definition of 14labeling tapes for 75performing on-demand 103

policiesactivating 102configuring

Avamar backup filter 99Avamar client filter 95export schedule 92policy details 91

creating 90deactivating 102definition of 14deleting 102performing on-demand exports for 103summary 89, 100viewing

by Avamar server 88clients included in 89export job details 104

schedulesconfiguring 92Nth day of each month 94on-demand 95regular intervals 94specific date each month 95specific weekdays 94

Export Policy Management page 86external Avamar servers

definition of 14troubleshooting 141

Ffiltering

backups 99framework

administrator account 19, 134configuring system settings 39disabling message settings 41enabling message settings 40

Framework Configuration springboard 39

GGoogle Chrome 18

IImport & Export Job History

report 112springboard 66, 112

Import & Restore springboard 60, 106Import server

definition of 14in Backup Browse/Import page 106resetting 111status of on Configuration springboard 61troubleshooting 138

import, definition of 14important terms and definitions 14importing

Avamar backups from tape 108backups from partial import file 109full backups 109


IndexIndex


partial backups 109inventorying library contents 85

Jjobs, setting the maximum number that can run in parallel 61

Llabeling tape volumes 75libraries

ACSLS 123inventorying 85labeling tape volumes in

as bootstrap tapes 75as export tapes 75

physical and virtual 12viewing details of 81viewing tape volumes in 82

lockbox password 18, 133Log Information springboard 55Log Viewer 56logging

in 18, 133out 27

loginaccount lockout 20failure

error message 19unlocking a user account 33

logs 55configuring the log level 39saving log files 56viewing in the Log Viewer 56

MManagement Information Base 121Max Ack. Events, configuring 40Media Access node 14

changing the root password 117media management

labeling tape volumes 75Media Management springboard 66, 149message settings 39

disabling 41enabling 40

MIB 121Mozilla Firefox 18My Profile springboard 36My Workspace 24

adding springboards to Springboards list 24copying springboards to 24removing springboards from Springboards list 25

NNth day of each month 94

Oon-demand exports

configuring 95

performing for a client 103performing for an export policy 103

online help 26

Pparallel jobs, setting the maximum number that can run 61partial import file 109password

changing 37requirements 31, 37

physical libraries 12policy. See export policiespools. See tape pools

RRecent Events springboard 62recovery images

applying 134creating 132

regular intervals 94report, Import & Export Job History 112resetting

a user password 37the import server 111

restore, definition of 15restoring backups to a client 112retention periods

custom 72default system 72definition of 15editing for backups 111setting for backups 91viewing associated pools 73viewing details 73

role management 33editing a user’s roles 34generating a user role report 36role types 34

Role Management springboard 33root password

changing on the Media Access node 117

SScheduled Exports springboard 59, 86Security Event Viewer 51

clearing the security threat level in 55viewing event details in 51

security events 50archiving 54deleting 54

Security Events springboard 50security threat level 50

clearing 55session timeout 20

configuring 40SNMP

configuring 41MIB 121traps 117

Index 155


Index

configuring for Avamar server 117configuring for tape management system 119

sorting backup column information 110specific date each month 95specific weekdays 94springboards

adding to a workspace 22Configuration 60copying to My Workspace 24definition of 15Event Summary 42Framework Configuration 39Import & Export Job History 66, 112Import & Restore 60, 106list 21Log Information 55Media Management 59, 66, 149moving 22My Profile 36opening 58Recent Events 62removing from a workspace 22Role Management 33Scheduled Exports 59, 86Security Events 50Task Monitoring 64, 104Task Summary 47User Management 30

Springboards listadding springboards to My Workspace 24editing 24removing springboards from in My Workspace 25

Storage Management Systemdefinition of 15events for 62

supported browsers 18suser 19system configuration 39

disabling message settings 41enabling message settings 40

system events 42exporting in CSV format 46sorting 44updating 44viewing event details in the Event Viewer 43

system settings 39configuring 39log level 39Max Ack. Events 40session timeout 40

Ttape pools

custom 67default system 68deleting 71editing 70relabeling volumes in 79viewing associated retention periods 73viewing details of 68

viewing volumes in 69tape volumes

ejecting 84importing Avamar backups from 108labeling 75

as bootstrap 78for export 77

relabeling to a different pool 79viewing backups on 82viewing those in a pool 69

Task Monitoring springboard 64, 104Task Summary springboard 47Task Viewer 47, 65

opening 104viewing export job details in 104

tasks 47viewing details of in the Task Viewer 47

terms and definitions 14threat level 50

clearing 55timeout, session 20TOOLBAR tab 21, 22troubleshooting 137

export failures 146external Avamar server issues 141file index reporting full 150import failures 144import server issues 138JavaScript errors 151library issues 148task failed or completed with exceptions 150timeout messages 151

Uunlocking a user account 20, 33user accounts

creating 30disabling 32editing 31role types 34unlocking 33

user management 30creating user accounts 30disabling a user account 32editing user accounts 31unlocking user accounts 33

User Management springboard 30user name

description of 31suser 19

user profile management 36changing name and email address 37changing password 37editing email message settings 38

User Role Report 36user roles

editing 34


IndexIndex


Vviewers

Event 43, 62Log 56Security Event 51Task 47, 65

virtual libraries 12volumes. See tape volumes

Wweb browsers

Mozilla Firefox 18workspaces

accessing 21Administration 20, 21Avamar Extended Retention 23definition of 15displaying springboards in 23hiding springboards in 23moving springboards around in 22My Workspace 24

adding springboards to Springboards list 24copying springboards to 24removing springboards from Springboards list 25

opening springboards in 58WORKSPACES tab 21

Index 157


Index


emc avamar 7.0 extended retention · emc avamar 7.0 extended retention user guide 7 preface as part...

Documents