docu53425 data domain boost for symantec openstorage 3.0.0.1 directed availability

5/19/2018 Docu53425 Data Domain Boost for Symantec OpenStorage 3.0.0.1 Directed Availability

1/7

Release Notes

EMCData Domain BoostRelease number 3.0.0.1

EMC Data Domain Boost for Symantec

OpenStorage Release Notes

302-000-426REVISION 01

May, 2014

This document contains the release notes for the EMC Data Domain Boost (DD Boost) forOpenStorage version 3.0.0.1- 430231. The sections listed here describe the release indetail and provide late-breaking or other information that supplements the main userdocumentation.

Note

Always check the EMC Online Support site http://support.emc.comfor the latest version ofthis document before proceeding. Any printed or CD-based version of this document may

be out of date.

Your suggestions will help us continue to improve the accuracy, organization, and overallquality of the user publications. Please send your opinions of this document [email protected].

u Revision History......................................................................................................... 2u DD Boost for OpenStorage Software........................................................................... 2u New Features in Release 3.0.......................................................................................2u Fixed in Release 3.0.0.1-430231................................................................................3u Known Issues and Workarounds................................................................................ 3u DD Boost for Symantec OpenStorage Configuration Recommendations......................5u DD Boost for Symantec OpenStorage Commands....................................................... 6u DD Boost for OpenStorage Documentation.................................................................6
mailto:[email protected]://support.emc.com/


2/7

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

Table Revision History of DD Boost for Open Storage Release 3.0

Revision Date Description

01 May 9, 2014 Initial publication.

DD Boost for OpenStorage SoftwareThe DD Boost for OpenStorage software is a licensed option that allows a Data Domainsystem to act as an OpenStorage storage server for Symantec's NetBackup and BackupExec products. The DD Boost for OpenStorage software includes a plug-in (referred to asthe Data Domain OST plug-in) that runs on the supported NetBackup and Backup Execmedia servers defined in the DD Boost Compatibility Guide. For specific software andhardware configurations tested and supported by Data Domain, log in to the EMC OnlineSupport site http://support.emc.comto see the compatibility lists.

Note

For detailed information on installing DD Boost for OpenStorage, see the Data Domain

Boost for OpenStorage Administration Guideand the Data Domain Boost Compatibility

Guidefor upgrade information.

Note

For information about accessing DD Boost documents on the EMC Online Support site,

see DD Boost for OpenStorage Documentation on page 6.

New Features in Release 3.0u Multiple DD Boost user support per systemThis release supports the DD Boost plug-

in version 3.0 which enables multi-user capability, enhancing security access andauthorization. This functionality provides these capabilities:

l Access control and isolation for each instance of DD Boost.

l Storage Unit access control per DD Boost user.

l Username and password authentication for each application using DD Boost.

l Stream management can be performed per storage-unit.

l Tenant-unit option is available for the Secure Multi-Tenancy use cases.

u IPv6 support for DD Boost clients.

u Additional OS platforms are also supported for DD Boost:

l MacOS 10.9 (32-bit and 64-bit).

l Windows 7, Windows 8, Vista.

Release Notes

2 EMC Data Domain Boost3.0.0.1 Release Notes
http://support.emc.com/http://support.emc.com/


3/7

Fixed in Release 3.0.0.1-430231The following important fixes and changes were made in DD Boost for SymantecOpenStorage Version 3.0.0.1-430231.

Table 2 DD Boost 3.0.0.1-430231: Fixed

Bug # Description

94761 Fixed an issue where the retransmission of a virtual synthetic message due to a

problem in the network, could cause the backup to fail. With the fix in place the

retransmitted virtual synthetic message should succeed if it doesn't encounter the

same network issue.

105938 Addresses the issue where the plug-in iterates a storage unit because NetBackup

did not provide a complete image definition that included img_saveas.

108386 Condition where stspi_create_image_dowould cause an invalid argument

error (5008) and the error is reported.

111889 This fix changes the way the fully qualified domain names are discovered for the

Linux, Windows, and AIX clients. Customers who currently have short names

configured for their client on the Data Domain system using the ddboost access

or ddboost ifgroupcommands may need to correct these client entries to

include the domain name. With this change, customers will be able to leverage

partial name checks for fully qualified domain names, for example, *.domain-name

when using both the ddboost accessand ddboost ifgroupcommands.

112211 Upgrade of OpenSSL to 1.0.1glibrary to prevent exposure to Heartbleed issue.

112433 Backups can fail with a segfaultseen on some Solaris media servers due to

libcrypto.so file on system.

Known Issues and WorkaroundsGeneral Issues

In some circumstances the Open Storage application does not send complete imageinformation (img_policy, img_saveas, and img_flags) to the plug-in. (This is not a

violation of the Open Storage API specification). In most of these cases, the plug-inalgorithmically determines the missing information (img_flagsand img_saveas) and

uses DDP_LOOKUPto find the file. In the rare case that img_policyis missing, theplug-in performs an iterative search of the storage unit by using a number ofDDP_READDIRRPCs. This situation can occur during an Automatic Image Replication

import with some versions of NetBackup. This situation also occurs with Backup Exec atthe end of each backup job.

On larger Data Domain systems with over 100,000 files in a given storage unit, theDDP_READDIRRPCs are a burden on the Data Domain system and will cause

performance to deteriorate. The Open Storage plug-in has been updated to minimize theuse of DDP_READDIR, but there is no complete fix at this time. You can use the

commands ddboost show statsand ddboost show histogramsto monitor for

DDP_READDIR.

EMC Data Domain Boost for Symantec OpenStorage Release Notes

Fixed in Release 3.0.0.1-430231 3


4/7

While running a full system accelerator backup with forced rescan and change journaloptions, NetBackup may fail with error 27 (child process killed by signal). This is a knownproblem (ETrack 34211834). There is an EEB for 7.5.0.7 and 7.6.0.2. It will be fixed in7.6.0.3.

Solaris 10

On a Sparc T4-1 running Solaris 10, a problem has been reported with a plug-in crashwhile using distributed segment processing. By default for Sparc, distributed segmentprocessing is disabled, so this problem only occurs if distributed segment processing hasbeen enabled. The crash is instigated by the intermittent failure of Solaris to load apkcs11 module required. The Solaris system log will show messages as below:

...[ID 169204 user.error]libpkcs11:/usr/lib/security/64/pkcs11_softtoken_extra.sosignature verification failed. See cryptoadm(1M).Skipping this plug-in....[ID 925218 user.error]libpkcs11: /usr/lib/security/64/pkcs11_kernel.so signatureverification failed.See cryptoadm(1M). Skipping this plug-in.

Note

This issue is resolved by Oracle patch 150531-01 for Oracle Solaris on SPARC (32-bit).

Starting with the DD Boost 3.0 plug-ins, a plug-in code change is being made to avoid thecrash by reverting to a much lower performance software only method. The system logwill still show the messages as above and the backup performance will be seriously (2x)degraded in performance.

Known Workarounds:

1. Disable distributed segment processing for Sparc.

2. An upgrade to Solaris 11 may correct the problem.

NetBackup

u NetBackup 7.x accelerator requires an external types file to enable accelerator. Theexternal types file requires a Data Domain specific entry to enable accelerator on aData Domain system.

The resolution for this issue is to apply the updated external types file available fromSymantec:

l UNIX/Linux: http://www.symantec.com/docs/TECH203427

l Windows: http://www.symantec.com/docs/TECH203428

u In versions of NetBackup prior to 7.5.0.4, jobs may fail with a message such as:

11/07/2012 11:58:35 - Critical bptm (pid=9739) A portion of data to be included

from a previous backup (backupid = ostqa-linux2_1351870224, offset = 661288960,length = 36352) has incorrect checksum (calculated checksum from backup imagefaf2aff1392269d36db7dbcc211f3d97b3f526ed, expected checksum2345ea1603b4cb4ae2c29e5f6a9353e7832faee6)

The workaround for this issue is to upgrade to 7.5.0.4 or later.

u Automatic Image Replication (AIR) jobs may fail in the case where the target DataDomain system has insufficient inbound opt-dupe streams.NetBackup starts the AIR process for each file of an image set in parallel. The plug-inhas no control or visibility into how many. In the case where the source Data Domainsystem has insufficient outbound opt-dupe streams, the plug-in is able to retry eachfile as resources become available. However, in the case that the target Data Domainsystem has insufficient inbound opt-dupe streams, the opt-dupe job fails with no

retry. This problem can happen in two general cases:

Release Notes

http://www.symantec.com/docs/TECH203428http://www.symantec.com/docs/TECH203427


5/7

l In the case of 1 source Data Domain system to 1 target Data Domain system,the target opt-dupe target stream count is less than source opt-dupe sourcestream count. This can happen when a large Data Domain system (e.g., DD890) isthe source a small Data Domain system (e.g., DD640) is the target.

l In the case of 2 or more source Data Domain systems to 1 target Data Domain

system, the target opt-dupe target stream count is less than the sum of all ofsource opt-dupe source stream counts. This can happen in the case of multipleData Domain systems (e.g., 3 DD670s) opt-duping to a single Data Domain system(e.g. DD670).

The workaround is to plan the number of AIR jobs.

To plan the number of AIR jobs, you must know the number of total files for an AIRbackup/opt-dupe. AIR backup will create three meta files for each backup path in apolicy plus any number of file fragments for the data. The number of file fragmentscan be determined by dividing the size of each backup selection path by theNetBackup storage unit fragment size.

Example:

The Netbackup policy backup selection lists five (5) 1GB directories and the storageunit max fragment size is 500GB. This will generate 5 files for each of the 5directories listed in the policy backup selection totaling 25 files AIR will need to opt-dup. 3 meta files + 2 data file fragments (1GB /500GB) = 5 files x 5 backup selections= 25 total files

In the above example to ensure the duplication is successful you need a minimum of25 streams available on the destination Data Domain system.

u If the number of concurrent jobs exceeds the maximum stream count on the GlobalDe-duplication Array (GDA), a PANIC will occur due to lack of file descriptors.Published stream counts include backup, restore and file-replication against allstorage units on a Data Domain system.

Backup Exec

u Backup Exec can only initiate managed file replication from a Single Node DataDomain system. It cannot initiate managed file replication from an ExtendedRetention Data Domain system or GDA due to a problem with the fast-copy to makethe phantomfile.

u If the number of concurrent jobs exceeds the maximum stream count on the GDA, apanic will occur due to a lack of file descriptors.Published stream counts include backup, restore and file-replication against allstorage units on a Data Domain system.

DD Boost Stream History

In case the data is missing for a certain timestamp, all the counter values will be filledautomatically by the system with 0 or with the counter value of the previous timestamp.

DD Boost for Symantec OpenStorage Configuration

Recommendationsu NetBackup accelerator activation requires:

l An enterprise NetBackup license with the Accelerator feature. This license isobtained from Symantec.

l An updated external_typesfile from Symantec. Please see: http://

www.symantec.com/business/support/index?page=content&id=TECH55064for


DD Boost for Symantec OpenStorage Configuration Recommendations 5
http://www.symantec.com/business/support/index?page=content&id=TECH55064http://www.symantec.com/business/support/index?page=content&id=TECH55064http://www.symantec.com/business/support/index?page=content&id=TECH55064


6/7

details. EMC Data Domain will be enabled in the latest external_typesfile

upon the completion of our qualification with the Symantec HCL.

DD Boost for Symantec OpenStorage Commands

On the Data Domain system, enter the command help ddboostfor a list anddescription of all Boost for Symantec OpenStorage commands. Also see the Data DomainBoost for OpenStorage Administration Guidefor information about the DD Boost forSymantec OpenStorage commands.

DD Boost for OpenStorage DocumentationDocumentation for DD Boost for OpenStorage is available on the EMC Online Support sitehttp://support.emc.com

To view documentation:

Procedure

1. Connect to the EMC Online Support site http://support.emc.com.

2. If you are a registered user, log in and skip to the next step. Otherwise, perform thefollowing:

a. Select Register Here.

b. Follow the online registration steps, filling in all required fields.

c. Once your registration is processed, you will receive an email confirmation.

3. Click the Support by Productoption.

4. Enter Data Domain Boost - Open Storage in the Find a Productfield.

5. On the next screen, select Documentation.

6. On the right side of the screen, all documents are displayed that fit the criteria. Amenu on the left side of the screen automatically populates with various categories ofthe displayed documents, for example, Release Notes, Manual and Guides, and so on.

Release Notes

http://support.emc.com/http://support.emc.com/


7/7

Copyright 2014 EMC Corporation. All rights reserved. Published in USA.

Published May, 2014

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

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

license.

EMC, 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 EMC Online Support (https://support.emc.com).


DD Boost for OpenStorage Documentation 7

docu53425 data domain boost for symantec openstorage 3.0.0.1 directed availability

Documents