Documentum Foundation Classes 7.2 Release Notes
Documentum Foundation Classes 7.2 Release Notes
Foundation Classes
Version 7.2
Release Notes
EMC Corporation
Corporate Headquarters
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Legal Notice
Copyright © 1994-2015 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 listing of EMC product names, see EMC Corporation Trademarks on EMC.com. Adobe and Adobe PDF
Library are trademarks or registered trademarks of Adobe Systems Inc. in the U.S. and other countries. All other trademarks
used herein are the property of their respective owners.
Documentation Feedback
Your opinion matters. We want to hear from you regarding our product documentation. If you have feedback about how we can
make our documentation better or easier to use, please send us your feedback directly at [email protected]
Table of Contents
3
Table of Contents
4
Revision History
5
Preface
6
Chapter 1
Overview
The EMC Documentum Foundation Classes 7.2 Release Notes contains customer-reported bug fixes
and platform compatibility updates. This document also includes a list of fixed problems, known
problems and limitations.
DFC is a key part of the Documentum software platform. While the main user of DFC is other
Documentum software, you can use DFC in any of the following ways:
• Access EMC Documentum functionality from within one of your company’s enterprise
applications.
• Customize or extend products.
• Write a method or procedure for Content Server to execute as part of a workflow or document
lifecycle.
In terms of Documentum functionality, DFC lies between Content Server and clients and are used for
server-side business logic and customization.
Resources
Product resources are available on the Web.
7
Overview
Providing Feedback
Documentation Feedback
Your opinion matters. We want to hear from you regarding our product documentation. If you have
feedback about how we can make our documentation better or easier to use, please send us your
feedback directly at [email protected].
8
Chapter 2
Features and Updates
This section highlights the major functionality changes included in this release. Refer to the product
documentation for complete information about these features.
9
Features and Updates
10
Chapter 3
System Requirements
The EMC Documentum 7.2 Environment and System Requirements Guide contains the system
requirements information for your product. This documentation is available from EMC Online
Support (https://support.emc.com).
11
System Requirements
12
Chapter 4
Installation and Upgrade
Before beginning installation, ensure that your system meets the requirements listed in Chapter 3,
System Requirements. After installation, be sure to update your software to the latest patched release.
The EMC Documentum Foundation Classes 7.2 Installation Guide contains information about how to
install DFC 7.2 on your application servers.
13
Installation and Upgrade
14
Chapter 5
Fixed Issues
This section identifies issues that have been resolved in this release.
15
Fixed Issues
16
Chapter 6
Known Issues
This section identifies known product issues and limitations that may affect your use of the product.
Issue Description
Number
DFC-12824 When you use Java bundled with Documentum to generate the certificates using the
command keytool.exe -genkey -alias tomcat -keyalg RSA -keystore
jms.keystore -storepass password, the following error appears:
17
Known Issues
Issue Description
Number
DFC-11749 Authentication to client applications like TaskSpace, Webtop, and Documentum
Administrator fails due to changes in the RSA encryption algorithm (FIPS).
Workaround: To enable your client such as TaskSpace 6.7 SP2 to work with Content
Server 7.1, you must perform the following steps to update the dm_bof_registry user
password since Content Server 7.1 uses a different encryption algorithm (FIPS/SHA1)
than the one that earlier versions of Content Server use (MD5):
1. Decrypt the dm_bof_registry user password using the decrypt API of the
RegistryPasswordUtils class in DFC 7.1 to get the plain text password.
2. Encrypt the plain text password using the encrypt API of the
RegistryPasswordUtils class in DFC 6.7 SP2 on the client.
18
Known Issues
Issue Description
Number
DFC-1376 Using PIA, the client is unable to use the getContent() method to read data into
(DFC-6012) memory. The recommended approach for reading the data into memory is to use a
code snippet such as the following:
dfclientX.ByteArrayInputStreamToString (sysObject.getContent())
(The return value of getContent() is not a defined class in C#/.NET.) This approach
works for ASCII data. For non-ASCII data, only a small portion of the data is read .
DFC-1179 A .NET program using DFC reads the log4j.properties file only when the properties
(DFC-5815) file is inside the C:\Documentum\Config folder. Placing the properties file in another
folder in the CLASSPATH does not work.
DFC-11735 DFC 6.7 SP2 running in the secure mode is not compatible with Content Server 7.1
that has certificates created for both DOCBROKER and DOCBASE. This combination
causes the following error message:
DfException in TDfSummaryLogManager.java: unable to make
docbase connection! DfDocbrokerException:: THREAD: main; MSG:
[DFC_DOCBROKER_REQUEST_FAILED] Request to Docbroker "dualcs:1489"
failed; ERRORCODE: ff; NEXT: null
DFC-11635 Removing a user using the method IDfGroup.removeUser from a group object
on which an audit trail event is enabled causes insert-related audit information to
be unexpectedly recorded in the audit trail record in addition to the delete-related
audit information.
Workaround: To achieve better performance, enable the ticket cache on the server
side.
DFC-9900 For the 7.0 release, we made changes to the DFC cryptography code. We replaced the
non-FIPS 140–2 MD5 algorithm with SHA1. This means that beginning with the DFC
7.0 release, all passwords will be encrypted using the new algorithm. Older (pre-7.0
release) DFC clients that attempt decrypt post–7.0 release encrypted passwords will
fail. However, a post-7.0 release DFC can still decrypt pre-7.0 release encrypted
passwords (with a warning), for backward compatibility.
DFC-1073 The getChildRelatives method of a class that implements the IDfPersistentObject
(DFC-5709) interface always returns the child_id of the dm_relation object, regardless of the
value of child_label.
19
Known Issues
Issue Description
Number
DFC-843 If you check out a replica of a document, the system checks the original document out
(DFC-5480) as well. If you check in the replica, the system checks the original back in as well.
However, DFC does not support checking out a replica, then subsequently checking
in the original directly.
DFC-697 When an XML document contains the pre-defined XML entities of > and ’ or any
(DFC-5334) numeric entity in an XML attribute, the entity is expanded in an exported document.
The numeric entities are expanded for those characters that are not in the character
set of the exported document. This means that the markup
<technology transfer="<Analog> & "Digital ' ¥"/>
will be exported as
<technology transfer="<Analog> & "Digital ' Y/>
where Y is the symbol for Yen.
DFC-695 The DFC IDfExportOperation does not preserve the line sequence from original XML
(DFC-5332) content. For example, if the original sequence of elements is:
<books>
<book>
Sequence after Export:
<books><book>
While this behavior might be unexpected, the XML content is still valid.
DFC-452 It is not possible to lock a rendition to prevent it from being deleted. For example,
(DFC-5093) when you try to export an object, and at the same time another user with appropriate
permission over the object deletes it, the deletion succeeds and the you will get an
error.
N/A DFC does not check, before deleting a document, to see if that document is a child of
a virtual document in another repository. For example, assume Doc A, in repository
1, is the root document, Doc B is a child of Doc A that lies in repository 2, and Doc C
is a child of Doc B that lies in repository 1.
DFC does not report an error if you delete Doc B, but the containment object that
bound Doc B to Doc A still exists in repository 1. As a result, if you log into repository
1, it looks to DFC as if Doc B is still part of Doc A. If you then perform operations on
Doc A, DFC might report errors.
N/A You cannot use classes of the com.documentum.operations package within
transactions in a multi-threaded environment.
20
Known Issues
Issue Description
Number
N/A DFC supports some OLE compound documents on Windows platforms. DFC
supports only the following:
• OLE compound links in Word and PowerPoint
In particular, DFC does not support OLE compound documents in Access, Outlook,
or Visio. It does not support circular references in links.
Compound documents (for example, OLE and XML) cannot be children of virtual
documents.
N/A If you add an object to an IDfExportOperation more than once, but with different
formats, the operation exports the object to a single file on the file system.
Workaround — Structure your application in such a way that you do not need
to invoke these method.
N/A The equals method of an IDfTime object returns a value of true if the method’s
argument represents a time that is within one second of the time that the object
represents.
N/A If you use an import operation to import a Windows file system folder and its
contents into a repository, and if the folder contains a shortcut to a file or folder in
another folder, DFC does not import the file or folder referenced by the shortcut.
21
Known Issues
Issue Description
Number
N/A The file download dialog box does not appear when attempting to perform file
transfer operations such as checkout, view and edit in Webtop.
The Checkout and view files using Webtop in Internet Explorer, page 23 section
provides information on how to change the Internet Explorer 7, 9, 10, and 11 security
settings.
N/A Importing a document on Macintosh platform does not import (and later export) the
’File Comments’ of the document, viewable through the ’Get Info...’ operation.
N/A The copy operation from one SSO to another SSO does not work.
N/A The Limitations of DFC in a 64-bit JVM environment, page 23 section provides
information on limitations of DFC in a 64-bit JVM environment.
N/A DFC validation methods obtain the locale from sessionconfig.session_locale and use
that locale in data dictionary queries. If the data dictionary does not have information
for that locale, the queries return an empty result set, rather than information for the
most closely matching locale.
22
Known Issues
Expression evaluation in native code will not work because it requires loading 32-bit dlls, which does
not work in a 64-bit JVM environment.
Workaround — To make this work in a 64-bit JVM environment, you can convert C++ expressions to
Java expressions using the following methods:
• dmc_MigrateDbExprsToJava: Used to migrate expressions defined for multiple object types.
• dmc_MigrateDbExprsToJavaForType: Used to migrate expressions defined for a particular type.
For example:
apply,c,NULL,DO_METHOD,METHOD,S,
dmc_MigrateDbExprsToJava,SAVE_RESULTS,
B,T,ARGUMENTS,S,-docbase Imaging1 -user dmadmin
-ticket <your_ticket_or_password>-select all -listExprsOnly false
23
Known Issues
Some DFC operations need to store state information. DFC can use either a file or Windows registry
to store this state information. DFC has native implementation of Windows dll for using the Windows
registry. This dll is a 32-bit dll file and cannot be loaded in a 64-bit JVM environment.
Workaround — For Documentum 6.0 and later versions, the default registry mode is ‘file’.
Therefore, this issue does not occur unless ‘windows’ registry is explicitly configured for usage. For
running DFC in a 64-bit JVM, use file based registry.
OLE
DFC provides a mechanism for scanning and patching OLE links in Microsoft Office documents.
DFC has native implementations in the form of Windows dlls for scanning and patching these links.
These dlls are 32-bit dll files and cannot be loaded in a 64-bit JVM environment.
In the case of a WDK application, the application server’s error log shows the following error:
javax.xml.parsers.FactoryConfigurationError:
Provider null could not be instantiated:
java.lang.NullPointerException
24
Known Issues
25
Known Issues
WARNING: Keystores are not swappable, copyable or shareable. They are sensitive security
information. If one needs, for any reason, to change a keystore, then stop the client, delete the
keystore, and restart the client. On restart, the client will create a new keystore. All the privileges
associated with the destroyed keystore, however, will be lost.
Documentation
Issue Number Description
DFC-12579 Intelligent Session Management (ISM): The Intelligent Session Management
(ISM) enhancements in Documentum 7.0 helps to improve the overall performance
and scalability through lower context switches on the Content Server and lower
number of active sessions on the Content Server.
For backward compatibility, this option can be set to false. When set to false, the
DFC session optimizations will not be used and the session always encapsulates
the underlying connection. This might reduce session scalability as connection
associated with the session is freed to the level-2 pool only when the session
expires (5 seconds by default).
N/A Product documentation might contain references to client applications and
functionality that are not supported in the 7.x release, though these applications
and functionality may become compatible in a future release. Only those client
applications documented as compatible in the EMC Documentum 7.x Environment
and System Requirements Guide are supported in 7.x.
26