You are on page 1of 12

EMC Centera

EMC SDK
Linux
Version 3.2 Patch 5

Release Notes
P/N 085090655
REV. A25
December 31, 2009

These release notes contain supplemental information about this release


of the EMC Centera SDK Version 3.2 Patch 5. Topics include:

Revision history .................................................................................... 2


Product description.............................................................................. 3
New features and changes .................................................................. 3
Fixed problems ..................................................................................... 4
Environment and system requirements ............................................ 6
Known problems and limitations ...................................................... 7
Technical notes ...................................................................................... 9
Documentation ..................................................................................... 9
Software media, organization, and files.......................................... 10
Installation ........................................................................................... 11
Troubleshooting and getting help .................................................... 12

Revision history

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

Revision

Date

Description

A25

December 31, 2009

EMC Centera SDK Linux Release Notes 3.2p5

A24

April 30, 2009

EMC Centera SDK Linux Release Notes 3.2p4

A23

October 10, 2008

EMC Centera SDK Linux Release Notes 3.2p3

A22

July 30, 2008

EMC Centera SDK Linux Release Notes 3.2p2

A21

March 6, 2008

EMC Centera SDK Linux Release Notes 3.2p1

A20

September 19, 2007 EMC Centera SDK Linux Release Notes 3.2

A19

November 29, 2006

EMC Centera SDK Linux Release Notes 3.1 SP1

A18

January 1, 2006

EMC Centera SDK Linux Release Notes 3.1

A16

November 1, 2005

EMC Centera SDK Linux Release Notes 3.0 SP1

A15

May 1, 2005

EMC Centera SDK Linux Release Notes 3.0

A14

March 21, 2005

EMC Centera SDK Linux Release Notes 2.4

A13

February 1, 2005

EMC Centera SDK Linux Release Notes 2.4

A11

September 1, 2004

EMC Centera SDK Linux Release Notes 2.3

A10

July 1, 2004

EMC Centera SDK Linux Release Notes 2.3

A08

February 1, 2004

EMC Centera SDK Linux Release Notes 2.1

A07

November 1, 2003

EMC Centera SDK Linux Release Notes 2.1

A06

August 25, 2003

EMC Centera SDK Linux Release Notes 2.0

A05

May 14, 2003

EMC Centera SDK Linux Release Notes 2.0

A04

May 1, 2003

EMC Centera SDK Linux Release Notes 1.2

A03

April 30, 2003

EMC Centera SDK Linux Release Notes 1.1

A02

April 20, 2003

EMC Centera SDK Linux Release Notes 1.0

A01

April 15, 2003

EMC Centera SDK Linux Release Notes 1.0

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Product description

Product description
These release notes support the EMC CenteraSDK v3.2 patch 5,
and supplement the previously published SDK v3.2 release notes and
suite of EMC Centera documentation, including v3.2 patch 1
through patch 4. For document sections where no new information is
noted, you must refer to the v3.2 release notes for the original text
presented therein.
The EMC Centera SDK v3.2 patch 5 is compatible with CentraStar
version 2.0 SP2 and higher.

Fixed in this patch


This patch release includes several fixed problems. You can find
detailed information on these issues in Fixed problems on page 4

Issue Tracker

For the most current listing of fixed and known problems, view them
online in Issue Tracker. Issue Tracker is a Powerlink web application
that allows EMC customers to scan and search information on issues
found in multiple EMC products.
To open Issue Tracker, follow these steps:
1. Go to the EMC Powerlink website at:
http://Powerlink.EMC.com.
2. From the menu bar, select Support > Interoperability and
Product Lifecycle Information > E-Lab Issue Tracker
Information > E-Lab Issue Tracker.
3. To familiarize yourself with how to use Issue Tracker, click E-Lab
Issue Tracker Help in the upper-right corner of the window.

New features and changes


There are no new features to report in this release.

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Fixed problems

Fixed problems
This section lists problems that were fixed in this release of EMC
Centera SDK v3.2 patch 5.

Performance
Issue Number

38651CEN

Fix Number

n.a.

Host OS

AIX|HP-UX|Linux|Solaris|Any Windows OS

Host Type

Any Host

Problem

API calls requiring authentication result in memory issues

Symptom

A memory issue was found in the Authentication process,which was more problematic when an
application made many calls to certain APIs (for example, GetPoolInfo,Query, ProfileClip, and
MOPI) and created a new or temporary connection instead of using an existing one.

Fix Summary

The memory issue was fixed.

Found in Version

3.2, 3.2 Patch 1, 3.2 Patch 2, 3.2 Patch 3, 3.2 Patch 4

Fixed in Version

3.2 Patch 5

Impact Level

2 - Medium

Compliance

Issue Number

38009CEN

Fix Number

n.a.

Host OS

AIX|HP-UX|Linux|Solaris|Any Windows OS

Host Type

Any Host

Problem

An Out of Memory condition results if a cluster has no Retention Classes defined and an
application attempts to retrieve the Retention Class Context

Symptom

Memory was being allocated based on the number of Retention Classes configured on the
system. Malloc was not behaving as expected when the length of the memory block attempting
to be allocated was 0.

Fix Summary

The Out or Memory condition no longer occurs when no Retention Classes are configured.

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Fixed problems

Found in Version

3.2 Patch 1, 3.2 Patch 2, 3.2 Patch 3, 3.2 Patch 4

Fixed in Version

3.2 Patch 5

Impact Level

3 - Low

Data Integrity
Issue Number

37475CEN

Fix Number

n.a.

Host OS

AIX|HP-UX|Linux|Solaris|Any Windows OS

Host Type

Any Host

Problem

Opening a C-Clip in FLAT_MODE does not find data associated with nested tags

Symptom

If a C-Clip containing data objects on nested Tags was opened in FLAT mode, the data item of
the nested tag was not available. C-Clips opened in TREE mode do not exhibit this problem.

Fix Summary

The tag traversal algorithm for FLAT mode was modified. The data objects of a C-Clip opened in
FLAT mode can now be associated with the applicable nested tags.

Found in Version

3.2 Patch 1, 3.2 Patch 2, 3.2 Patch 3, 3.2 Patch 4

Fixed in Version

3.2 Patch 5

Impact Level

3 - Low

Note: The most up-to-date product issues for EMC Centera SDK are detailed
online in the EMC Issue Tracker available on the EMC Powerlink website:
http://Powerlink.EMC.com.

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Environment and system requirements

Environment and system requirements


Application server platform
This section lists the system requirements for the application server
platform.
Client software platform

Red Hat Linux Advanced Server 4.0 (32-bit and 64-bit)

Red Hat Fedora Core 5 (32-bit and 64-bit)

SuSE Linux Enterprise Server 10 (32-bit and 64-bit)

SuSE Linux Enterprise Server 9 SP1 (32-bit and 64-bit)

Note: While the EMC Centera Linux SDK does not require the
above-referenced systems, they are the only distributions that are certified by
EMC. The SDK may work with any distribution of GNU/Linux that has glibc
2.2.4 or higher. Appropriate distributions include Debian, Mandrake, SuSE,
TurboLinux, and many others, inclusive homemade systems.

Linux development platform

For C/C++:
Linux 2.6.5 gcc 3.3 (libstdc++ 5 compatibility)/g++ 3.3
Linux 2.6.5 gcc 4 (libstdc++ 6 compatibility)/g++ 4

For 32-bit Java:


Sun JDK 1.5 and higher

Minimum system requirements Linux application server

Intel Pentium III, 550 MHz

512 MB RAM

100 Mbps Ethernet network card

Recommended system requirements Linux application server

Quad processor Pentium 4, 1 GHz

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Known problems and limitations

Known problems and limitations


This section includes only those known problems reported as of the
publication date of this document.

Options
Issue Number

32304CEN

Fix Number

n.a.

Host OS

AIX|HP-UX|Linux|Solaris|Any Windows OS

Host Type

Any Host

Problem

Using deprecated API FPStream_Write results in -10045 error at FPStream_Close time if strict
stream mode is enabled

Symptom

If the strict stream mode is enabled, using a deprecated API like FPStream_Write results in the
FP_STREAM_BYTECOUNT_MISMATCH_ERR (-10045) error when the stream closes.

Fix Summary

As a workaround, when using deprecated APIs like FPStream_Write, disable use of the
FP_OPTION_STREAM_STRICT_MODE option or environment variable.

Found in Version

3.2, 3.2 Patch 1, 3.2 Patch 2, 3.2 Patch 3, 3.2 Patch 4, 3.2 Patch 5

Impact Level

2 - Medium

Monitoring
Issue Number

28370CEN

Fix Number

n.a.

Host OS

AIX|HP-UX|Linux|Solaris|Any Windows OS

Host Type

Any Host

Problem

Call to FPMonitor_GetDiscoveryStream returns SECURITY_DENIAL when a node is offline

Symptom

If monitoring is enabled when a node is not responding, the call to


FPMonitor_GetDiscoveryStream returns an erroneous packet with the opcode for
MONITOR_CLOSE.

Fix Summary

When a node is not responding, the call to FPMonitor_GetDiscoveryStream returns an


erroneous response of SECURITY_DENIAL. When this occurs, check the availability of the EMC
Centera nodes with the access role.

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Known problems and limitations

Found in Version

3.0, 3.0 SP1, 3.1, 3.1 Patch 1, 3.1 Patch 2, 3.1 SP1, 3.2, 3.2 Patch 1, 3.2 Patch 2, 3.2 Patch 3,
3.2 Patch 4, 3.2 Patch 5

Impact Level

3 - Low

Compatibility
Issue Number

23723CEN

Fix Number

n.a.

Host OS

AIX|HP-UX|Linux|Solaris|Any Windows OS

Host Type

Any Host

Problem

The SDK v3.1 changed the behavior of how the SDK opens file streams in "a" or "a+" mode.

Symptom

Earlier SDK file stream APIs, when used with the 'a' or 'a+' permission, opened the existing file
with the stream position pointing at the start of the file. Starting with the SDK v3.1, the file now
opens with the stream position pointing at the end of the file.

Fix Summary
Found in Version

3.1, 3.1 Patch 1, 3.1 Patch 2, 3.1 SP1, 3.2, 3.2 Patch 1, 3.2 Patch 2, 3.2 Patch 3, 3.2 Patch 4, 3.2
Patch 5

Impact Level

3 - Low

Note: The most up-to-date product issues for EMC Centera SDK are detailed
online in the EMC Issue Tracker available on the EMC Powerlink website:
http://Powerlink.EMC.com.

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Technical notes

Technical notes
The following technical notes apply to the v3.2 SDK:

Beta releases of the Java JRE are not supported.

EMC recommends that you keep the total number of client


threads below 20 times the number of access nodes when
managing primarily small files (< 500 KB), or below 10 times the
number of access nodes when managing primarily large files
(> 500 KB).

When setting your FP_OPTION_WRITE_STRATEGY to


FP_REPLICATE_STRATEGY, you should not write to clusters that
have their storage strategy set to anything but capacity or you
will experience errors with your write operations.

CDFs that contain more than 64 attributes per tag and/or 64


levels of nested tags will not be accessible by client applications
that are delivered with a 2.1 or earlier SDK.

Documentation
The release notes for IRIX and the Windows GCC platforms are no
longer being published. The EMC Centera SDK v3.2 patch releases
are not applicable to the EMC Centera SDK IBM z/OS.

Documentation Suite
The following titles comprise the current documentation suite for the
EMC Centera SDK and EMC Centera SDK for XAM publications. The
EMC Centera Quick Start Guide, available in Powerlink, describes
related Centera documentation:
Part Number

Title

069001127

EMC Centera Programmers Guide

069001185

EMC Centera API Reference Guide

085090664

EMC Centera SDK AIX Release Notes

085090648

EMC Centera SDK HP-UX Release Notes

SDK
Guides

Release Notes

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Software media, organization, and files

Part Number

Title

085090655

EMC Centera SDK Linux Release Notes

300-001-374

EMC Centera SDK IBM z/OS Release Notes

085090647

EMC Centera SDK Solaris Release Notes

300-002-180

EMC Centera SDK Windows Release Notes

EMC Centera SDK for XAM


Guide

300-007-642

EMC Centera SDK for XAM VIM Reference Guide

Release Notes

300-007-643

EMC Centera SDK for XAM Windows Release


Notes

300-007-644

EMC Centera SDK for XAM Linux Release Notes

300-007-645

EMC Centera SDK for XAM HP-UX Release Notes

300-007-646

EMC Centera SDK for XAM Solaris Release Notes

300-007-647

EMC Centera SDK for XAM AIX Release Notes

Software media, organization, and files


The EMC Centera SDK is distributed electronically. The SDK
packages install the following items on the development machine:

Access API files

Documentation

Cookbook

Installation file

Note: Refer to the readme.txt file that accompanies the SDK package file
for the exact file names.

10

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Installation

Installation
To install the SDK on your system, follow these steps:
1. Go to your development directory and unpack and install the
package file as follows:
gzip d <filename>.tgz
tar xvf <filename>.tar

2. Go to the Centera_SDK/install subdirectory on your machine


and run the install script. Run the script with root privileges
since it installs files in system directories. You may want to
modify this script to reflect your own directory structure. Add the
directory where the libraries were installed to the library path
environment variable (LD_LIBRARY_PATH).
Note: To uninstall the Centera software from your machine, delete the
Centera directory tree from the directory where you have installed the
SDK.

Compilation and Link Flags


This section contains the compilation and link flags that enable you to
build the code samples (known as the Cookbook) that are included
with the EMC Centera SDK.
Note: The SDK no longer supports compilation with static libraries. You must
link with the dynamic libraries.

Red Hat Linux Advanced Server 4.0:


gcc -DPOSIX -I /opt/Centera_SDK/include -L
/usr/local/Centera_SDK/lib/32 -lFPLibrary
Note: The exchange of pool-specific information uses an external structure
(PoolInfo structure). The internal representation of the PoolInfo structure in
the library has been compiled using an 8-byte alignment setting.
To use the structure successfully, it is necessary to compile the application
using the same 8-byte alignment.

11

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes

Troubleshooting and getting help

If your application needs to be compiled on another alignment, then you may


need to add a pragma around #include <FPAPI.h> to specify the 8-bit
alignment solely for the structure.

Troubleshooting and getting help


EMC support, product, and licensing information can be obtained as
follows.
Product information For documentation, release notes, software
updates, or for information about EMC products, licensing, and
service, go to the EMC Powerlink website (registration required) at:
http://Powerlink.EMC.com

Technical support For technical support, go to EMC Customer


Service on Powerlink. To open a service request through Powerlink,
you must have a valid support agreement. Please contact your EMC
sales representative for details about obtaining a valid support
agreement or to answer any questions about your account.

Copyright 2009 EMC Corporation. All rights reserved.


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.
For the most up-to-date regulatory document for your product line, go to the Technical Documentation and
Advisories section on EMC Powerlink.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.
12

EMC Centera SDK Linux Version 3.2 Patch 5 Release Notes