download4.boulder.ibm.comdownload4.boulder.ibm.com/sar/cma/sta/03wso/0/pt_3.3.3... · web...

Version 3.3.3

IBM System Storage with ProtecTIER Software 3.3.3

© Copyright IBM Corporation 2011, 2013. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

References in this documentation to IBM® products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program or service is not intended to state or imply that only IBM's product, program or service may be used. Any functionally equivalent product, program or service that does not infringe any of IBM's intellectual property rights may be used instead of the IBM product, program or service. Evaluation and verification of operation in conjunction with other products, except those expressly designated by IBM, are the user's responsibility.

© 2013 IBM Corporation i


Table of Contents

Release Notes....................................................................................................1Introduction.............................................................................................................................1

Prerequisites............................................................................................................................1

Code levels...............................................................................................................................1

New features and resolved problems......................................................................................2

Upgrading the ProtecTIER software.........................................................................................3

Additional documentation.......................................................................................................4

Restrictions and known issues.................................................................................................5

Compatability...........................................................................................................................7

Documentation format............................................................................................................8

Notices and trademarks.............................................................................................9Notices.....................................................................................................................................9

Trademarks..............................................................................................................................9

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION.................9

© 2013 IBM Corporation ii


Release notesThese release notes are for IBM System Storage with ProtecTIER Software.

Release date 1 August 2013.

Introduction

This document is a reference for installation and contains other useful information about the IBM System Storage TS7650G, TS7610 and TS7620 with ProtecTIER V3.3.3.

Prerequisites

Prerequisites include the following:

ProtecTIER Manager V3.3.3 must be installed.

The full package code must already be installed on the system. The installation of this patch on a Linux OS system without the full package code already installed will fail.

Code levels

Code level requirements include the following:

Software VersionTS7650G Software level 3.3.3

dtcemulex 5233.004

ptlinux 7133.123

ptrepmgr 6133_79

©2013 IBM Corporation 1


New features and resolved problems

The ProtecTIER introduction and planning guides describe the new features in the release:

IBM System Storage TS7650 ProtecTIER 3.3 Deduplication Appliance and TS7650G Deduplication Gateway Introduction and Planning Guide (3958-AP1 and 3958-DD5) (GA32-0918-06)

or

IBM System Storage® TS7620 ProtecTIER® 3.3 Deduplication Appliance Express Introduction and Planning Guide (GA32-0913-04)

See the Additional documentation section for information about how to find these publications.

FSI new features:Fix ID Description81024048 Provided support for clone operation to a different file system

81024779 Support for larger than 8 Gb files

81024915 Support for cloning a local directory

51005270 Updated the CLI (ptcli) to support cloning a local directory.

81024736 Updated ganesha version to support NFS for Oracle application



VTL new features:Fix ID Description81023691 A new option was added:

'update_memory_requirements_file_max_tapes' to vtlutil utility.This method updated the memory_requirement.xml file in order toreduce the memory consumed by VTL tapes, according to thefollowing logic:

The new limits fall between 128 and 256 on a 32-byte boundary ‐(according to the current library configuration).

The new value must be equal to or greater than the current ‐number of CONFIGURED tapes.

If the calculated new limit is greater than the current limit, no ‐change is performed.

The backup configuration file with the current configuration is also generated.

51005295 Developed command line interface (ptcli) to support dedup estimator functionality

51005494Developed functionality for TSM enablement support

81025032

SNMP new functionality:

Fix ID Description81023802

Provided support for a new SNMP trapsink to send notification in case the replication backlog is low. It is relevant for all applications (VTL, FSI, OST)

81024587

51005318

ProtecTIER Server issues:VTL application:Issue ID Fix ID DescriptionN/A 81023394 Solved the issue in the compressor module, which may cause an

insufficient number of handles in the system

N/A 81025444 Increased virtual memory cache size per storage unit to support a large number of STUs in big repositories



21119 81024447 Solved the problem caused by running nr_diag tool

N/A 81023923 Enhanced native replication traces for field debugging

16775 81025316 Solved the replication segmentation fault issue

20239 81023817 VTR log consumption issues were solved

16993 81023113 Added printing of full file name in logs, while backing up

17787 81021538 Solved the issue of weeds file failure when replicating

20688 81023876 Updated SM2 6 TB license to support 11034 cartridges

21220 81025217 Solved the replication performance issue, where empty cartridges were being replicated

RTC 14979 81025010 Solved the slow backups, which were caused by stream accumulator buffer allocations

RTC 16570 81025408 Slow stopping of services was resolved

20534 81023456 Improved the stopping services process

RTC 12765 81024215 Added traces for troubleshooting in the case of system reboot caused by an incorrect VTL process state status in the CMGNTprocess

N/A 81024470 Changed the trace level from ERROR to WARNING in some CMFenced cases.

21232 81025516 Improved the compressor algorithm to resolve the slow delete in the hub during replication

18796 81024989 Solved the issue where snmp alerts were printed to a log file after system reboot

20903 81023890 Solved the issue of a default replication IP address used in place of a configured IP address

81023691 A new option was added:'update_memory_requirements_file_max_tapes' to vtlutil utility.This method updated the memory_requirement.xml file in order toreduce the memory consumed by VTL tapes, according to thefollowing logic: The new limits fall between 128 and 256 on a 32-byte boundary ‐

(according to the current library configuration). The new value must be equal to or greater than the current ‐

number of CONFIGURED tapes.

If the calculated new limit is greater than the current limit,‐no change is performed.

The backup configuration file with the current configuration is also generated.



RTC 14337 81024762 Solved an issue where the change of replication rate limits to 4 Mb/second caused log files to be filled with incorrect error messages

FSI application:Issue ID Fix ID Description20266 81024590 The data truncate failures issue was solved

20671 81023947 The modified time synch issue between source and distination during replication was solved

N/A 81023386 Added an option to store configuration file of samba after editing

20869 81024361 Updated GUI with relevant error message, when user is trying to cancel a clone operation

20424 81024776 Solved the restore failures issue, which was caused by wrong data merge behavior

21118 81024488 Solved the issue of the cloning process failure due to power outage

20898 81024241 Improved the trace messages for better investigation of failures

20830 81023827 Solved the issue where a power outage resulted in a restore file failure

20888 81023955 Updated the buffer state so that only legitimate status is provided

20736 81024176 Updated the log file messages to be more relevant for a backup state

21053 81024255 Solved an issue of cloning RDD failures after the increase of FS storage capacity

81024173 Resolved the issue of some data failing to truncate during a truncate operation

21006 81024443 Resolved the issue of slow directory browsing from the GUI

20619 81023569 Corrected the dedup ratio calculation

20721 81023669 Solved the issue of multiple errors being generated by a replication policy deletion without an empty replication backlog

21023 81024169 Resolved the failure of running replication to abort on command

20363 81024203 Corrected an issue where CIFS users cannot access new folders

21135 81024557 Improved the rollback mechanism behavior

20916 81024520 Corrected the truncate operation to last synch point for full repository to succeed

21032 81024972 Added POSIX time support for updating the file time state



21162 81024730 Added "data created" time attributes to the I/O navigation view

20025 81024778 Corrected the failure of replication backlog data to update after the removal of a replication policy

20653 81024562 Improved performance by increasing the number of buffers for the backup data

20779 81024243 Improved the delete data from repository mechanism

N/A 81024568 Solved the clone recovery operation failure issue

RTC 15585 81024949 Resolved the issue where running more than 2 clone jobs in parallel with replication causes the clone process to fail

RTC 15690 81024966 Resolved the problem of clone failures due to out-of-space issues, by improving the clone retry mechanism

RTC 15691 81025028 Solved empty RDD cloning failures

N/A 81023451 Added FNS support for 16 M files

17670 81024182 Resolved an issue where the recursive deletion of replicated files caused replication activities to fail

N/A 81024853 Improved the list mechanism in the GUI for backup andreplicated files

RTC 16534 81025187 Fixed the issue of a clone directory not being deleted on a destination file system

RTC 16740 81025240 Resolved the issue of metadata files not being deleted from a file system that is deleted

RTC 15844 81025066 Improved the log file notices for better troubleshooting of backup and restore issues

RTC 17816 81025558 Improved the power failure replication recovery mechanism

RTC 16866 81025325 Improved the log messages for replication status monitoring

21092 81024356, 81023869, 51005398

The issue when creating maximum amount of exports on the file system failed, was solved.Resolved the issue of the failure of the file system, when creating the maximum number of exports

21057 81024596 Solved lock issues by an improved stream accumulator mechanism

81024584 81024585

81024727 81025445 81025568 81025499

Improved the recovery mechanism for the event of system failure



RTC 14287 81024616 Improved the compressor quote implementation by adding new validations

20288 51005310 , 81024957

Resolved the issue where deleting FSI folders through the GUI did not properly update the ganesha cache, resulting in showing as non-exiting directories

20846 81023852 The clone throughput statistics function was updated

RTC 12527 81024314 Updated host's list format in exports view

20812 81023775 Solved the issue where share and export were created on the same folder

RTC 14570 81024659 Corrected the problem where there was a failure to create an NFS export to an existing directory

20644 81025114 Corrected an issue where files may get out of sync following a read operation

16432 81025156 Resolved an issue where the replication trigger queue does not always enter the retry mode more than once

21117 81024454 Fixed an issue with a timeout expired error message being printed to a log file during an I/O stress load

RAS/upgrade/configuration issues:Issue ID Fix ID Description18796 81024989 Resolved the issue of minor SNMP errors being generated during

the upgrade process

20534 81023456 Resolved the 15 minute time lapse between initiating the stop VTFD service and the actual service shutdown

N/A 81023536 Added verification for problem report file to the service report function

20529 81023557 Updated the management of service mode state for the health monitoring option in the SMB menu

20609 81023636 Added information messages to log files in the event of fdisk failures

20355 81023370 Resolved the restore network configuration failures during code upgrade

N/A 81023355 Fixed typo in log file message

20284 81023350 Resolved the loss of mac address after node replacement©2013 IBM Corporation 8


20881 81023894 51005210

Solved the multiple upgrade start time changes seen in the upgrading systems view

21159 81024736 To solve known fence issues, the following rpms were updated:

cman-2.0.115-109.el5_9.1

openais-0.80.6-37.el5

python-suds-0.4.1-2.el5

21081 81024305 Per RFC 1123, added legal host name characters validation

20900 81023945 Updated error message for incorrect date entry during service report creation

20872 81023860 Fixed a typo in the system message that showed up when installing an older version code package

21168 81024773 Updated the upgrade process and the start RAS service to run only after completion of the update cluster process

N/A 81024512 Resolved the RAS service failure to stop during an RedHat upgrade

20963 81024030 Corrected the upgrade process so timeouts will pause until the remote node has finished its reboot

21194 81024931 Resolved the issue of nodes stalling due to full filesystems

RTC 16126 81025076 Corrected the upgrading systems view so the upgrade incorrect sensor does not display

20750 81023726 Resolved the issue where illegal XML problems during an upgrade generated the call home feature

RTC 15678 81025086 Updated the expected ratio for an SMB2 20 TB machine to 10, to conform to the specifications

RTC 14123 81025053 Updated RAS for stability during the disabling of SMTP service

21236 81025320 Resolved the broadcom card fault, which resulted in the reboot of a node in the loop during version upgrade

RTC 12477 81025071 Corrected the parameters that caused SNMP startup failure

N/A 81023073 Updated MegaRAID firmware for SM1 machines

N/A 81025131 Updated PT server protocol version to allow connection to the PT GUI

21017 81025637 Increased the expected time for kpartx and dhcp uninstall during an upgrade



ProtecTIER driver issues:Issue ID Fix ID Description21179

52000328

Resolved an issue of the VTL drivers being changed to a “defined” mode during reboot in an AIX environment, by installing Emulex_9.5.3.6

ProtecTIER Manager issues:Issue ID Fix ID Description20643 51005194 A destination directory that was just removed through the GUI can

no longer be re-added20654 51005196 Create/Modify/Remove share/exports option is enabled on either

file or share/export selection view20405 51005197 Sorted the eth list entries by respective ID value in network view18365 51005205 Firmware level code upgrade is now updated in the GUI20803 51005217 Redefined the status of replicated data in the folder navigation

view from “N/A” to “0”19356 51005223 In the event of duplicate device names, the “node view devices”

now displays all of the correct information51005227 Changed code upgrade view status from "storage upgrade" to

"storage firmware upgrade51005230 Corrected the failure of file or folder erasure after ownership

change, due to maximum length of file or folder20961 51005237 Fixed auto logout to work from the GUI

20913 51005239 Fixed replication details view to show correct host name

20999 51005257 Corrected “All systems” view so empty repositories won’t show 100% storage savings

20000 51005318 Changed the protcol version to synchronize with PT server version

17926 51005381 Changed the string “Is Synch” to “In Synch”

RTC 16790 51005567 Updated description for backlog threshold SNMP alerts

21218 81025283 ”inventoryRefresh” and “inventoryStatistics” commands now work in ptcli

21094 51005599 PT GUI now works properly when installed in TSSC

RTC 18105 51005634 "ModifyFsiFileSystem" command now works in ptcli



Upgrading the ProtecTIER software

Important: For all upgrades or updates, follow instructions exactly as written, including when to stop and start vtfd and ptcluster services for each node.

For TS7610 or TS7620 Appliance Express systems, use the IBM System Storage® TS7610 and TS7620 ProtecTIER® v.3.3 Deduplication Appliance Express Software Upgrade Guide (SC27-3641) and choose one of the following options:

Upgrading a TS7610 or TS7620 system from v3.2 (Option A)

To upgrade to v3.3.3 from v3.2, follow the procedure described in Chapter 4, "Upgrading the ProtecTIER software to version 3.3 from version 3.2.x" in the IBM System Storage TS7610 and TS7620 Appliance Express ProtecTIER v. 3.3 Software Upgrade Guide (SC27-3641-04).

Upgrading a TS7610 or TS7620 system from v3.1.8 or higher (Option B)

To upgrade to v3.3.3 from v3.1.8 or above, follow the procedure described in Chapter 5, "Upgrading the ProtecTIER software to version 3.3 from version 3.1.8 or higher" in the IBM System Storage TS7610 and TS7620 Appliance Express ProtecTIER v.3.3 Software Upgrade Guide (SC27-3641-04).

Upgrading a TS7610 or TS7620 system from v2.4.x, v2.5.x or v3.1.X (any 3.1 version below 3.1.8) (Option C)

To upgrade to v3.3.3 from v2.4.x, v2.5.x or v3.1.x (any 3.1 version below 3.1.8), follow the procedure described in Chapter 6, "Upgrading ProtecTIER version 2.4 or 2.5 to RedHat 5.6 and version 3.3" in the IBM System Storage TS7610 and TS7620 Appliance Express ProtecTIER v. 3.3 Software Upgrade Guide (SC27-3641-04).

Updating a TS7610 or TS7620 system already at v3.3 with a fix update or patch (Option D)

Update a system already at v3.3 with a later fix update or patch by using the procedure described in Chapter 7, “Applying fixes to update the ProtecTIER software for version 3.3 and higher” in the IBM System Storage TS7610 and TS7620 Appliance Express ProtecTIER v. 3.3 Software Upgrade Guide (SC27-3641-04).

For TS7650 Appliance or TS7650G (Gateway) systems, use the IBM System Storage TS7650 ProtecTIER v. 3.3 Software Upgrade Guide (SC27-3643-04) and choose one of the following options:

Upgrading a TS7650 or TS7650G system from v3.1.8 or higher (Option A)

To upgrade to v3.3.3 from v3.1.8 or above, follow the procedure described in Chapter 4 (using ProtecTIER Manager) or Chapter 5 (using ProtecTIER Service Menu), "Upgrading the ProtecTIER software to version 3.3 from version 3.1.8 or higher" in the IBM System Storage TS7650 ProtecTIER v. 3.3 Software Upgrade Guide (SC27-3643-04).



Upgrading a TS7650 or TS7650G system from v2.4.x, v2.5.x or v3.1.X (any 3.1 version below 3.1.8) (Option B)

To upgrade to v3.3.3 from v2.4.x, v2.5.x or v3.1.x (any 3.1 version below 3.1.8), follow the procedure described in Chapter 6, "Upgrading Red Hat Linux and ProtecTIER for servers before version 3.1.8" in the IBM System Storage TS7650 ProtecTIER v. 3.3 Software Upgrade Guide (SC27-3643-04).

Updating a TS7650 or TS7650G system already at v3.3 with a fix update or patch (Option C)

Update a system already at v3.3 with a later fix update or patch by using the procedure described in Chapter 7, “Applying fixes to update the ProtecTIER software for version 3.3 and higher” in the IBM System Storage TS7650 ProtecTIER v. 3.3 Software Upgrade Guide (SC27-3643-04).

Additional documentation

The support homepage contains all relevant documentation.

To access the additional documentation:

In a web browser, navigate to http://www-947.ibm.com/support/entry/portal/overview

Search for the keyword “ProtecTIER”


http://www-947.ibm.com/support/entry/portal/overview%20


Restrictions and known issues

Restrictions and known issues include the following:

Before performing any configuration operation, upgrade both nodes to the same patch level.

Do not move a cartridge from the shelf of the remote repository while it is the target of a replication operation.

FSI Replication between 3.2.x and 3.3.x repository is supported only from 3.2.2.0 and higher.

The table below represents the maximal number of recommended concurrent streams with FSI Backup and Restore functions. Exceeding these limits may result in performance degradation which under extreme conditions could lead to timeouts in your backup jobs.

The maximum number of recommended concurrent streams is specified as a by product function of the repository configured Meta Data and User Data configuration throughput.

Therefore, this requires careful planning and consideration.

It is recommended that you not exceed this number.

Repository throughput 1 Number of streamsTS7620 3959-SM2 base 2 20 streams

TS7650(G) - 100-200MB/sec & TS7620 with 1 EXP

40 streams

TS7650(G) - 200-300MB/sec & TS7620 with 2 EXP

64 streams

TS765(G) - 300-450MB/sec 96 streams

TS7650(G) > 450MB/sec 192 streams (max # supported) 3

NOTES:1 – Repository supported throughput means that both the required Meta Data and User Data raids are configured to support the desired throughput.2 – No systems (Gateway) should be configured for less than 100MB/sec 3 – For NBU the max # of jobs supported is 128.



Issue ID Description Workaround20390 Decompress Failed Error during

restore/replicationIn Restore – perform Retry

In Replication – Retry will be performed automatically

20431 Following Active Directory Server reboot, ProtecTIER server cannot query users from it

On the ProtecTIER Sever run:

"service winbind restart"

20590 Fresh install displays some used space in ProtecTIER Manager

If the used space displayed is lower than 2GB then ignore

20678 Memory failures in SM2 might not trigger an alert

N/A



Compatability

Compatability requirements include the following:

ProtecTIER v3.3.3 works with TSSC code level 5.12.8 or later.

ProtecTIER v3.3.3 requires the use of ProtecTIER Manager v3.3.3.

ProtecTIER Manager earlier than v3.3.3 is not compatible with ProtecTIER Server v3.3.3. Communication between the two will fail.

Replication is supported from ProtecTIER v2.4 or later. SMB v2.1 systems are also supported.

Replication between ProtecTIER v2.3 and ProtecTIER v3.1.8 and above is NOT supported.

Replication configuration operations require the use of Replication Manager v3.3.1 or later ProtecTIER software.

OpenStorage compatibility:

ProtecTIER Server V3.3.3 is compatible with plugin 2.5.0.0 and later. OpenStorage plugin V3.3 is compatible with ProtecTIER Server V2.5.X and later.

Compatibility matrix:

To find the matrix should be taken these steps:1. Go to http://www-03.ibm.com/systems/storage/tape/index.html2. Scroll down to the heading "Virtual tape systems"3. Find either TS7650G or TS7620, and click the relevant link

TS7650G = http://www-03.ibm.com/systems/storage/tape/ts7650g/index.html TS7620 = http://www-03.ibm.com/systems/storage/tape/ts7620/index.html

4. Look for the "Learn more" heading (middle of the page), and click the PDF link for "Independent Software Vendor (ISV) matrix" document.



Documentation format

The publications for this product are in Adobe Portable Document Format (PDF) and should be compliant with accessibility standards.

If you experience difficulties when you use the PDF files and want to request a web-based format or accessible PDF document for a publications, send a request by email to [email protected]. In the request, be sure to include the IBM publication number and title.

When you send information to IBM, you grant IBM a nonexclusive right to use to distribute the information in any way it believes appropriate without incurring any obligation to you.



Notices and trademarks

NoticesINTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

TrademarksLinux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATIONThe license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version. Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions:

The Excluded Components are provided on an "AS IS" basis IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS

WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

IBM will not be liable to you or indemnify you for any claims related to the Excluded Components



IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components.


download4.boulder.ibm.comdownload4.boulder.ibm.com/sar/cma/sta/03wso/0/pt_3.3.3... · web...

Documents