Академический Документы
Профессиональный Документы
Культура Документы
System
Version 6.6
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
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. All other trademarks
used herein are the property of their respective owners.
© Copyright 2010 EMC Corporation. All rights reserved.
Table of Contents
Preface ................................................................................................................................. 9
Chapter 8 DFC, BOF and WDK Application Migration to DFS .................................... 159
Appendix A Migrating DMCL APIs to DFC .................................................................... 161
Overview ....................................................................................................... 161
Methods with no corresponding DFC method .................................................. 161
Methods with corresponding DFC methods ..................................................... 162
Appendix B Object Type and Property Changes for version 6.6 ................................... 171
New object types ............................................................................................ 171
Changed object types ...................................................................................... 172
Deprecated or obsolete properties .................................................................... 173
Properties added conditionally ........................................................................ 173
Deprecated or obsolete object types ................................................................. 174
List of Figures
List of Tables
This guide focuses on the steps necessary to upgrade or move an existing EMC Documentum 5.3 SP6
or 6 implementation to the EMC Documentum 6.5 or later platform. This guide does not focus on new
features, except when a new feature changes or replaces existing behavior in custom applications.
Intended Audience
This guide is for EMC Documentum administrators who are tasked with upgrading or moving an
existing EMC Documentum 5.3 SP6, 6.0, or 6.0 SPx implementation into the EMC Documentum 6.5 or
later platform and developers who have created custom applications that need to move from EMC
Documentum 5.3 SP6, 6.0, 6.0 SPx, 6.5, or 6.5 SPx to the EMC Documentum 6.6 platform.
Document scope
This guide shows you how to upgrade a Documentum system and migrate your customizations to
the upgraded Content Server. To assist you in the upgrade process, refer to Content Server Installation
Guide for more detailed planning information.
The safe harbor release for migration to 6.5 and later versions is version 5.3 SP6. If you are upgrading
from a version earlier than 5.3, you must first upgrade to version 5.3 SP6, and then to version 6.5 or a
later version. Alternatively, if you are on version 6.0 or 6.0 SPx, you can upgrade to version 6.5 or
a later version.
For migration of your customizations, this guide takes a version 5.3 SP6, 6.0, or 6.0 SPx
implementation and provides appropriate instructions to transition to 6.5 or a later version. You can
take advantage of some but not all of the new features of 6.5 and later versions. This guide also shows
you how to disable new behaviors where you do not want them and activate some features that have
been deprecated or "turned off” by default for 6.5 and later versions. For information on how to
implement new features in your custom client application, refer to the developer documentation for
the product, for example, the Web Development Kit Development Guide for WDK.
IMPORTANT: All references to 6.5 and later versions in this document refer to version 6.5 and all
versions that follow it. For example, such a reference includes version 6.6.
Additional documentation
This guide provides overview and planning information. For details on specific procedures see
these guides:
• Content Server Installation Guide
• Documentum Administrator User Guide
• XML Store Migration Guide
• Documentum Foundation Classes Development Guide
• Web Development Kit and Webtop Deployment Guide
• Web Development Kit Development Guide
• Webtop Email Migration Guide
• Documentum Foundation Services Development Guide
• Documentum Foundation Services Deployment Guide
Revision History
The following changes have been made to this document.
Revision History
This chapter covers in broad terms what is meant by upgrade and migration, what this guide covers,
and where you might look for additional information.
These topics are included:
• Upgrade and migration, page 11
• Understanding migration, page 12
• Order of new product installation, page 12
• System upgrade strategies, page 14
• Order of system updates, page 13
• Changing the database OS and version, page 17
• Changing the content store location, page 17
• Migrating XML content to the XML store, page 17
Note: DocApps, SBOs and TBOs (BOF2 version), and Java methods bundled as SBOs will continue to
work in an upgraded Content Server. To edit them, you must create a project. Refer to the "Managing
Modules” chapter of Documentum Composer User Guide.
Check the installation or deployment guide for each application that you are upgrading to find
instructions for upgrading or migrating applications to the new version. For information on
migrating WDK-based customizations, refer to Chapter 7, Migrating WDK and Webtop Applications.
Before upgrade and migration, check the interoperability of all products and platforms in the system.
Refer to Chapter 4, Interoperability and Compatibility.
Understanding migration
Migrating from version 5.3 SP6 or 6.0, or 6.0 SPx to 6.5 or a later version is a straightforward
process. Your task is to clearly document your current configuration, plan your version 6.5 or later
configuration, then upgrade the individual system components in a sequence that will minimize
impact on your users.
Migration can be separated into two basic tasks:
• Install and configure version 6.5 or later software.
• Move configurations and customizations to the new servers.
— Make necessary changes to enable any features you want to keep.
— Make necessary changes to disable any new features you do not want.
— Make necessary changes to enable any new features for existing custom components.
Most of the new features in 6.5 and later versions are enabled by default. For those feature that are
not enabled by default, this guide explains the steps for enabling the new feature.
Caution: For Content Server, host OS, or RDBMS upgrades, make sure the product version is
supported by the Content Server version you are installing. For application server OS or server
upgrades, make sure the product version is supported by the WDK-based application you are
installing. This information is in the product release notes.
you should use the test environment as a practice environment for performing the production
system upgrade.
Note: The Content Server/database component (the repository) is the only part of the system for
which there is an upgrade script. All other system product component require a fresh installation.
The upgrade strategy provided in this section addresses upgrading all products in the system to the
same version number, resulting in a homogenous system. You can also upgrade only the Content
Server/database component (the repository) or the client component, resulting in a heterogeneous
system. Chapter 4, Interoperability and Compatibility provides additional details on mixed version
compatibilities.
Figure 3, page 16 shows the high-level decision points involved moving from a test system to a
production system. Functional testing of new customizations and manual migration of existing
customizations into new client version is part of the develop phase.
If upgrading the repository, you need to create a copy of the production repository (see Content
Server Installation Guide) in your test system upon which you can run the upgrade. If you want to
change the database operating system, you can using the utilities available through the third-party
database to export the database and import it into a new database instance on the different operating
system. After running the Content Server configuration program to re-establish the connection
between the existing Content Server instance and new database instance, run the Content Server to
upgrade the entire repository.
If you are performing a fresh install, instead of an upgrade, you need to migrate your data files to new
Content Server and database instances. There are several known third-party utilities for performing
this data migration (Crown Partners, Bluefish, FME).
An EMC Documentum system requires a global registry repository that matches the version family of
the system clients. After installing or upgrading the test system repository, install a global registry
repository matching the version of the client applications and install the client software. If your client
software versions are to remain at the same version as your production system, you can copy the
customized files from your production system directly over to the same version client instance
on the test system. If the client version software is different, you need to manually migrate your
customizations over to the new client files.
Upon completing the migration of customizations to the test system, ensure your system is running
properly by conducting your system tests. You are ready to repeat your upgrade process on the
production once all your system tests pass. Generally, you will need to take your production system
off-line for a weekend while performing the in–place upgrade.
Note: You can use virtual machine hosts for the entire system or system components. Using virtual
machines, you can swap out pre-upgraded system images on the same physical host to minimize
the downtime of an in-place upgrade.
The production system contains new content and full-text indexes generated since the repository was
copied or you migrated your data to the new repository.
Upgrading a system presents an opportunity to change to new host environments. The following
topics will help you plan your system size and improve performance:
• Planning the system size, page 19
• Planning for performance, page 20
• Common problems in Server performance, page 21
• Common problems in Server performance, page 21
High availability Documentum Server clusters — Server clusters (also called Server sets) can be
active-active or active-passive. In an active-active cluster, there are two active load-balanced web
application servers, two active sets consisting of a Content Server and connection broker, one active
RDBMS with clustered standby server, one primary database with one synchronized standby, and
one primary content store with one synchronize standby. In an active-passive cluster, everything
is the same except that there is only one active Server plus connection broker set, with another
set as standby.
These cluster configurations provide partial high availability coverage with increased scalability.
The clusters can be managed with Documentum Administrator.
Disaster recovery — Disaster recovery is not the same as high availability. It assumes a total loss of
the production data center. Disaster recovery servers are separate and independent from the main
center. They share no resources, and each has an independent network infrastructure for WAN
replication. Both systems have the capacity to carry out full normal and emergency workloads. They
must be maintained to be completely compatible.
Failover for disaster recovery is manual, not automatic. Clients will be affected.
Enhancing query performance — The Documentum Administrator User Guide describes how to
monitor query performance using the Update Statistics administration tool. It also describes how to
limit poorly-performing subqueries for users who belong to a large number of groups.
Migrating a system requires planning. You have to know your starting point, choose a destination,
then pick the best route to get there. This chapter provides some practical advice for plotting your
course from version 5.3 SP6, 6.0, or 6.0 SPX to version 6.5 or later. Topics in this chapter include:
• Changes in supported environments, page 23
• Version 6.5 and later changes that impact Content Server upgrade or migration, page 24
• Mapping your current configuration, page 29
• Designing a version 6.5 or later configuration, page 32
• Planning upgrade and migration to version 6.5 or later, page 34
You can set the preference dfc.compatibility.truncate_long_values to true to silently throw away data
as in the past. The default for this preference is false. This default is chosen to avoid data loss, even
though it is incompatible with previous versions.
If you prefer to use the pre-6.5 behavior, set the following dfc preference in dfc.properties to:
dfc.compatibility.truncate_long_values
When you get this new exception, the preferred solution is to carefully examine the application and
resolve the real source of the problem. Chances are that silently discarding the data is not your
desired result. If fixing the application is not an option, you can set the preference in dfc.properties to
allow truncation.
External storage
If you are using an external storage area and the plugin is configured to execute on the client host,
you need to reconfigure the plugin to execute on the server. In 6.5 and later versions, DFC does not
support executing the plugin on the client. To configure the plugin to execute on the server, set the
a_exec_mode property of the storage object to F (FALSE). The storage object is one of dm_extern_file,
dm_extern_free, or dm_extern_url, depending on the type of external storage you are using.
If an application, such as Documentum Administrator, that has an explicit login dialog box is
installed on a Content Server host, a user is able to login as the installation owner without a password
using a trusted login.
This release introduces a new dfc.properties key to turn off trusted logins if you do not want to allow
trusted logins through such applications. The key is:
dfc.session.allow_trusted_login
Setting this key to false requires users to always provide a password, even when logging in as the
installation owner.
DQL changes
The following are changes to the DQL.
The POSITION keyword, previously supported in SELECT queries against the fulltext index, is
no longer supported.
CHANGE...OBJECT statement
Previously, using the CHANGE...OBJECT statement was restricted to custom object types. With this
release, the statement may be used to change any type so long as the remaining restrictions as listed
in the DQL Reference manual description of CHANGE...OBJECT are not violated.
You can now specify ’utc’ in a date literal in a DQL statement. The new syntax for date literals is:
DATE(’date_value[utc]’ [,’pattern’])
You can define date_value using any of the valid character string formats representing a date, or it can
be one of the keywords that represent dates.
If utc is included, Content Server assumes that the specified date_value is UTC time. The specification
of utc is not case sensitive.
then reapply any changes made prior to the save or checkin before reattempting the save or checkin
operation. This behavior is different from how failed saves or checkins were handled by the prior
DMCL. The DMCL in prior releases simply marked the object as in an error state and returned
it to the application.
enable_workitem_mgmt obsolete
The enable_workitem_mgmt key controls whether permissions to perform certain workflow actions
are enforced. The affected actions are:
• Acquiring a work item
• Delegating a work item
• Halting and resuming a running activity
• Changing a work item’s priority
If the key is set to T (TRUE), any user can perform those actions. The key is F (FALSE) by default.
from which you can get much of this information. If you do not, be sure to keep a copy of the existing
plan to help with future migrations. Take the time to verify that any existing diagrams reflect the
current configuration.
Complete one copy of the table below for each server host and client configuration used in your
current system, for example, Content Server, fulltext indexing server, Federated Search Server,
application server.
Item Value
Hardware and
Processors
Memory
Operating system and
version
Content Server version
RDBMS and version
Repository size Number of objects:
Item Value
Hardware and
processors
Memory
Operating system and
version
HTTP Server version
Java version
DFC version
Other product and
version
Other product and
version
Other product and
version
Item Value
Hardware and
processors
Memory
Operating system and
version
HTTP server version
Java version
DFC version
Other product and
version
Other product and
version
Other product and
version
Item Value
Operating system and
version
Browser and version
Java version
Other product and
version
Other product and
version
Other product and
version
• Needs changes
• Obsolete
• Needs changes
• Obsolete
• Needs changes
• Obsolete
Content Server and an application server, this is a good time to divide the functions between two or
more server hosts to boost performance.
This can be any arbitrary user login name and password. Do not use the repository owner’s
credentials or the installation owner’s credentials.
• If you do not configure the repository as a global registry, the user is created with a default value
for the login name and the user state is set to Inactive.
If you later enable the repository as a global registry, use Documentum Administrator to change
the user state to Active and provide the user with a user login name and password that you
choose. Refer to the Content Server Installation Guide for instructions on enabling the repository
as a global registry.
Client-first migration
If your system uses only Webtop, DFS, custom DFC, or custom WDK clients, you have the option of
migrating the client applications first. Refer to the installation or deployment guide for the client
application for detailed instructions.
ACS and BOCS version compatibility and migration — Parallel streaming from ACS will be used
only if both ACS and UCF (WDK or DFS applications) are version 6.5 or later. Parallel streaming from
BOCS will be used only if ACS, BOCS, and UCF are version 6.5 or later.
Note: When you upgrade the BOCS to version 6.5 or later, you must update the BOCS version
specification in the global registry using Documentum Administrator. For BOCS 6.0, you must
specify the version as 2.0. For BOCS 6.5 or later, you must specify the version as 2.1.
WDK clients compatibility and migration — WDK-based clients are compatible with version
5.3 SP6 and version 6 Content Server. Based on the version to which you have migrated, some
WDK features of that version will be available, such as those that run in JavaScript on the client.
Other features will not be available until you complete the migration to version 6.5 or later, such as
lightweight sysobjects, data partitioning, batch processing, and scoping.
These are the steps to migrate from version 5.3 SP6, 6.0, or 6.0 SPx to version 6.5 or later, migrating
the clients first.
5.3 Y
5.3 and 6 N
5.3 and 6.5 Y
5.3 and 6.6 Y
5.3, 6, and 6.5 N
5.3, 6, 6.5, and 6.6 N
6, 6.5, and 6.6 N
6 and 6.5 N
5.3 6.5 and 6.6 Y
5.3 N
6 Y
6.5 N
6.6 Y
5.3 and 6 N
5.3 and 6.5 N
5.3 and 6.6 N
5.3, 6, and 6.5 N
5.3, 6, 6.5, and 6.6 N
6 and 6.5 Y
6 6.5 and 6.6 Y
5.3 N
6 Y
6.5 Y
6.6 Y
5.3 and 6 N
5.3 and 6.5 N
5.3 and 6.6 N
5.3, 6, and 6.5 N
5.3, 6, 6.5, and 6.6 N
6 and 6.5 Y
6.5 6.5 and 6.6 Y
5.3 N
6 Y
6.5 Y
6.6 Y
5.3 and 6 N
5.3 and 6.5 N
5.3 and 6.6 N
5.3, 6, and 6.5 N
6, 6.5, and 6.6 Y
6.6 5.3 , 6, 6.5, and 6.6 N
Note: For more information about Configuration requirements in a Federation, see the Distributed
Configuration Guide.
Repositories with object replication — Upgrade the source repository, then the target repositories.
If you have a group of repositories where each repository is both a source and a target, the upgrade
can begin with any of the repositories. This can apply, for example, if objects are replicated from
repository A to repository B, repository B to repository C, and from repository C to repository A. You
can replicate between repositories that use different Content Server versions, but you lose attributes
that are in the newer version, since they cannot be replicated to a version that does not contain them.
Content Server version 6.5 or later supports replication on server version 5.3 SP6 only.
Repositories with distributed or load-balanced content — Shut down the primary Content Server
and all content-file servers. Upgrade the primary Content Server first, then upgrade the content-file
servers.
Note: For more information about upgrading a distributed configuration, see the Content Server
Installation Guide.
Unless otherwise noted, any 5.3 SP6, 6.0, 6.0 SPX, 6.5 or later product can coexist with any other 5.3
SP6, 6.0, 6.0 SPX, 6.5 or later product on the same host. Mixed versions (5.3 SP6 with 6.0, 6.0 SPx, 6.5
or later) cannot share the same application instance.
In addition, unless otherwise noted, all 6.x SPx products can interoperate with all other 6.x products.
Interoperability takes place when different client applications perform operations on the same object
instance in a repository.
Mixed version compatibility, page 39, provides detailed information for determining compatibility
between different version client applications and Content Server. The Cross-product dependencies and
interoperability section of each product’s release notes provides a list of products depended on by a
product and additional products with which a product generally interoperates.
Note: None indicates that the client application does not have any modules, aspects, TBOs, or SBOs.
Table 10. Upgrade matrix for Content Server and related components
Content Server
Content Server 5.3 SP6 6 6 SP1 6.5 6.5 SP1 6.5 SP2 6.5 SP3 6.6
5.3 SP6 Y Y Y Y Y Y Y Y
6 NA Y Y Y Y Y Y Y
6 SP1 NA NA Y Y Y Y Y Y
6.5 NA NA NA Y Y Y Y Y
6.5 SP1 NA NA NA NA Y Y Y Y
6.5 SP2 NA NA NA NA NA Y Y Y
6.5 SP3 NA NA NA NA NA NA Y Y
6.6 NA NA NA NA NA NA NA Y
6.5 N Y Y Y Y Y Y NA
6.5 SP1 N Y Y Y Y Y Y NA
6.5 SP2 N Y Y Y Y Y Y NA
6.5 SP3 N Y Y Y Y Y Y NA
6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA Y* Y* Y* NR Y* Y* Y*
6 NA NA Y Y NR Y Y Y
6 SP1 NA NA NA Y NR Y Y Y
6.5 NA NA NA NA NR Y Y Y
6.5 SP1 NA NA NA NA NR Y Y Y
6.5 SP2 NA NA NA NA NR NA Y Y
6.5 SP3 NA NA NA NA NR NA NA Y
6.6 NA NA NA NA NR NA NA NA
6.5 SP3 NR NR NR NA NA NA NA Y
6.6 NR NR NR NA NA NA NA NA
6 NA NA Y Y Y Y Y NR
6 SP1 NA NA NA Y Y Y Y NR
6.5 NA NA NA NA Y Y Y NR
6.5 SP1 NA NA NA NA NA Y Y NR
6.5 SP2 NA NA NA NA NA NA Y NR
6.5 SP3 NA NA NA NA NA NA NA NR
6.6 NA NA NA NA NA NA NA NA
6.5 SP3 NA NA NA NA NR NR NR NR
6.6 NA NA NA NA NA NA NA NA
Content Server
My Documentum Offline 5.3 SP6 6 6 SP1 6.5 6.5 SP1 6.5 SP2 6.5 SP3 6.6
6 SP1 N Y Y NA NA NA NA NA
6.5 SP1 N N Y Y Y NA NA NA
6.5 SP2 N N Y Y Y Y NA NA
6.6 N N Y Y Y Y Y Y
Note: The following notes are applicable to products listed in Table 10 with a Y*:
• Ensure that the version of the Web Publisher Server files is the same as the version of Content
Server. If the versions do not match, you must place the JARS at the location specified in the
Upgrade Notes section of the Web Publisher Release Notes.
• When CIS 5.3 SP6 users upgrade to version 6x, 6.5, 6.5 SP2, or 6.5 SP3, some CIS features available
through legacy tools may no longer work.
Based on the guidelines in Guidelines for determining mixed version compatibilities, page 40, Table
11, page 49 summarizes whether a specific client version works with a 5.3 SP6 repository and a 6.x
SPx repository. Unless otherwise noted, 6.x SPx indicates any of the following releases: 6.0, 6.0
SP1, 6.5, and 6.5 SPx.
Note: Many products consist of multiple installed components (WAR file, DAR file or DocApp, for
example). Mixing versions of these components (6.0 WAR file and 6.5 DAR file, for example) for a
particular (6.5) product version is not supported.
Table 11. Compatibility matrix for client components against Content Server and dependent products
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y** Y**
NA NA 6.5 SPx Y Y Y Y Y Y Y** Y**
6.5 SP2 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP3 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.6 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA Y N N N NR N N N
6 NA NA NA N Y Y* Y* NR N N N
6 SP1 NA NA NA N Y Y Y NR Y* Y* Y*
6.5 NA NA NA N Y Y Y NR Y* Y* Y*
6.5 SP1 NA NA NA N Y Y Y NR Y* Y* Y*
6.5 SP2 NA NA NA N Y Y Y NR Y Y Y
6.5 SP3 NA NA NA N Y Y Y NR Y Y Y
6.6 NA NA NA N Y Y Y NR Y Y Y
5.3 SP6 NA NA NA Y Y Y Y Y Y Y Y
6 NA NA NA Y Y Y Y Y Y Y Y
6 SP1 NA NA NA Y Y Y Y Y Y Y Y
6.5 NA NA NA Y Y Y Y Y Y Y Y
6.5 SP1 NA NA NA Y Y Y Y Y Y Y Y
6.5 SP2 NA NA NA Y Y Y Y Y Y Y Y
6.5 SP3 NA NA NA Y Y Y Y Y Y Y Y
6.6 NA NA NA Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA NA NA NA
6 NA NA NA NA NA NA NA NA NA NA NA
6 SP1 NA NA NA NA NA Y NA NA NA NA NA
6.5 NA NA NA NA NA Y Y NA NA NA NA
6.5 SP1 NA NA NA NA NA NA NA Y NA Y NA
6.5 SP2 NA NA NA NA NA NA NA NA Y Y Y
6.5 SP3 NA NA NA NA NA NA NA Y Y Y NA
6.6 NA NA NA Y NA NA NA NA Y NA Y
5.3 SP6 NA NA NA NA NA NA NA NA NA NA NA
6 NA NA NA NA NA NA NA NA NA NA NA
6 SP1 NA NA NA NA Y Y NA NA NA NA NA
6.5 NA NA NA NA Y Y Y NA NA NA NA
6.5 SP1 NA NA NA NA Y Y Y Y NA NA NA
6.5 SP2 NA NA NA NA Y Y Y Y Y NA NA
6.5 SP3 NA NA NA NA Y Y Y Y* Y* Y* NA
6.6 NA NA NA NA Y Y Y Y Y Y Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx NA NA NA NA NA NA Y Y
5.3 SP6 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SP6 Y Y Y Y NA NA NA Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y NA Y Y Y Y
6 SP1 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y NA Y Y Y Y
6.5 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y NA Y Y Y Y
6.5 SP1 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y NA Y Y Y Y
6.5 SP2 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y NA Y Y Y Y
6.5 SP3 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SPx Y NA NA NA NA NA NA Y
6.0 SPx NA NA Y Y Y Y Y Y
6.5 SPx NA NA NA NA Y Y Y Y
6.6 NA NA 6.6 NA NA NA NA NA NA NA Y
5.3 SP6 NA NA NA Y N N N N N N N
6 NA NA NA Y Y N N N N N N
6 SP1 NA NA NA Y Y Y N N N N N
6.5 NA NA NA Y Y Y Y N N N N
6.5 SP1 NA NA NA Y Y Y Y Y N N N
6.5 SP2 NA NA NA Y Y Y Y Y Y N N
6.5 SP3 NA NA NA Y Y Y Y Y Y Y N
6.6 NA NA NA Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA Y N N N N N N N
6 NA NA NA Y Y N N N N N N
6 SP1 NA NA NA Y Y Y N N N N N
6.5 NA NA NA Y Y Y Y N N N N
6.5 SP1 NA NA NA Y Y Y Y Y N N N
6.5 SP2 NA NA NA Y Y Y Y Y Y N N
6.5 SP3 NA NA NA Y Y Y Y Y Y Y N
6.6 NA NA NA Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA Y Y Y Y Y Y Y Y
6 NA NA NA Y Y Y Y Y Y Y Y
6 SP1 NA NA NA Y Y Y Y Y Y Y Y
6.5 NA NA NA Y Y Y Y Y Y Y Y
6.5 SP1 NA NA NA Y Y Y Y Y Y Y Y
6.5 SP2 NA NA NA Y Y Y Y Y Y Y Y
6.5 SP3 NA NA NA Y Y Y Y Y Y Y Y
6.6 NA NA NA Y Y Y Y Y Y Y Y
5.3.x and
5.3 SP6 later NA NA Y NA NA NA NA NA NA NA
5.3.x and
6 later NA NA N Y NA NA NA NA NA NA
5.3.x and
6 SP1 later NA NA N Y Y NA NA NA NA NA
5.3.x and
6.5 later NA NA Y Y Y Y NA NA NA NA
5.3.x and
6.5 SP1 later NA NA Y Y Y Y Y NA NA NA
6.5 SP2
6.5 SP2 and later NA NA N Y Y Y Y Y NA NA
6.5 SP2
6.5 SP3 and later NA NA N Y Y Y Y Y Y NA
6.5 SP2
6.6 and later NA NA NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA NA NA NA NA NA NA NA NA
6 NA NA NA NA NA NA NA NA NA NA NA
6 SP1 NA NA NA NA NA NA NA NA NA NA NA
6.5 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP2
6.5 SP1 and later NA NA N Y Y Y Y NA NA NA
6.5 SP2
6.5 SP2 and later NA NA N Y Y Y Y Y NA NA
6.5 SP2
6.5 SP3 and later NA NA N Y Y Y Y Y Y NA
6.5 SP2
6.6 and later NA NA NA NA NA NA NA NA NA NA
1.0 NA NA NA Y NA NA NA NA NA NA NA
6.0.1 NA NA NA N N Y NA NA NA NA NA
6.5 SP3
(WINDOWS,
SOLARIS - SPARC) NA NA NA N N N N Y Y Y NA
6.6 (WINDOWS,
SOLARIS - SPARC,
LINUX (IA-x86)) NA NA NA N N N N Y Y Y Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
5.3 SP6 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP3 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.6 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 Y Y Y Y Y Y Y Y
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
5.3 SP6 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP3 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
6.6 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA NA NA NA
6 NA NA NA NA NA NA NA NA NA NA NA
6 SP1 NA NA NA NA NA NA NA NA NA NA NA
6.5 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP1 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP2 NA NA NA N Y Y Y Y Y NR Y
6.5 SP3 NA NA NA NR NR NR NR NR NR NR NR
6.6 NA NA NA NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NA NA NA NA
6 NA NA NA NA NA NA NA NA NA NA NA
6 SP1 NA NA NA NA NA NA NA NA NA NA NA
6.5 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP1 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP2 NA NA NA Y Y Y Y Y Y NR Y
6.5 SP3 NA NA NA NR NR NR NR NR NR NR NR
6.6 NA NA NA NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA Y Y Y NA NA NA NA NA
6 NA NA NA Y Y Y NA NA NA NA NA
6 SP1 NA NA NA Y Y Y NA NA NA NA NA
6.5 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP1 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP2 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP3 NA NA NA NA NA NA NA NA NA NA NA
6.6 NA NA NA NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA Y Y Y NA NA NA NA NA
6 NA NA NA Y Y Y NA NA NA NA NA
6 SP1 NA NA NA Y Y Y NA NA NA NA NA
6.5 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP1 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP2 NA NA NA NA NA NA NA NA NA NA NA
6.5 SP3 NA NA NA NA NA NA NA NA NA NA NA
6.6 NA NA NA NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA Y Y Y Y Y Y Y NA
6 NA NA NA Y Y Y Y Y Y Y NA
6 SP1 NA NA NA Y Y Y Y Y Y Y NA
6.5 NA NA NA Y Y Y Y Y Y Y NA
6.5 SP1 NA NA NA Y Y Y Y Y Y Y NA
6.5 SP2 NA NA NA Y Y Y Y Y Y Y NA
6.5 SP3 NA NA NA Y Y Y Y Y Y Y NA
6.6 NA NA NA NA NA NA NA NA NA NA NA
NA 5.3 SP6 NA NA NA NA NA NA NA NA
6.x 6.0 SPx Y Y Y Y Y Y Y NA
6.x 6.5 SPx Y Y Y Y Y Y Y NA
6.5 SP2 NA NA 6.6 NA NA NA NA NA NA NA NA
NA 5.3 SP6 NA NA NA NA NA NA NA NA
6.x 6.0 SPx Y Y Y Y Y Y Y NA
6.x 6.5 SPx Y Y Y Y Y Y Y NA
6.5 SP3 NA NA 6.6 NA NA NA NA NA NA NA NA
NA 5.3 SP6 NA NA NA NA NA NA NA NA
6.x 6.0 SPx NA NA NA NA NA NA NA NA
6.x 6.5 SPx NA NA NA NA NA NA NA NA
6.6 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 N N N N N N N N
6.0 SPx Y* Y* Y* Y* Y* Y* Y* Y*
6.5 SPx Y* Y* Y* Y* Y* Y* Y* Y*
6 SP1 NA NA 6.6 Y* Y* Y* Y* Y* Y* Y* Y*
5.3 SP6 N N N N N N N N
6.0 SPx Y* Y* Y* Y* Y* Y* Y* Y*
6.5 SPx Y* Y* Y* Y* Y* Y* Y* Y*
6.5 NA NA 6.6 Y* Y* Y* Y* Y* Y* Y* Y*
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
6.5 SP1 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
6.5 SP2 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
6.5 SP3 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
6.6 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA N N N N N N Y
6.0 SPx NA Y Y Y Y Y Y Y
6.5 SPx NA Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 NA Y Y Y Y Y Y Y
5.3 SP6 NA N N N N N N Y
6.0 SPx NA Y Y Y Y Y Y Y
6.5 SPx NA Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 NA Y Y Y Y Y Y Y
5.3 SP6 NA N N N N N N Y
6.0 SPx NA Y* Y* Y* Y* Y* Y Y
6.5 SPx NA Y* Y* Y* Y* Y* Y Y
6.5 SP3 NA NA 6.6 NA Y* Y* Y* Y* Y* Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
6.6 NA NA 6.6 NA NA NA NA NA NA NA NA
Global
DA CTS Registry Content Server
Records Manager Version Version Version 5.3 SP6 6 6 SP1 6.5 6.5 SP1 6.5 SP2 6.5 SP3 6.6
5.3 SP6 N N N N N N N Y
6.0 SPx Y Y Y Y Y Y Y Y
6.5 SPx Y Y Y Y Y Y Y Y
5.3 SP6 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6 SP1 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6.5 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6.5 SP3 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
6.6 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6 SP1 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6.5 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N Y Y Y Y Y Y Y
6.0 SPx N Y Y Y Y Y Y Y
6.5 SPx N Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 N Y Y Y Y Y Y Y
5.3 SP6 N N N N N N N Y
6.0 SPx N Y* Y* Y* Y* Y* Y* Y
6.5 SPx N Y* Y* Y* Y* Y* Y* Y
6.5 SP3 NA NA 6.6 N Y* Y* Y* Y* Y* Y* Y
5.3 SP6 NA NA NA NA NA NA NA NA
6.0 SPx NA NA NA NA NA NA NA NA
6.5 SPx NA NA NA NA NA NA NA NA
6.6 NA NA 6.6 NA NA NA NA NA NA NA NA
5.3 SP6 NA NA NA Y NA NA NA NA NA NA NA
6 NA NA NA NA Y Y N N N N N
6 SP1 NA NA NA NA Y* Y N N N N N
6.5 NA NA NA NA N N Y Y Y Y Y
6.5 SP1 NA NA NA NA N N Y* Y Y Y Y
6.5 SP2 NA NA NA NA N N Y* Y* Y Y Y
6.5 SP3 NA NA NA NA N N Y* Y* Y* Y Y
6.6 NA NA NA NA N N Y* Y* Y* Y* Y
5.3 SP6 NA NA NA Y NA NA NA NA NA NA NA
6 NA NA NA NA Y Y Y Y Y Y NA
6 SP1 NA NA NA NA Y* Y Y Y Y Y NA
6.5 NA NA NA NA Y* Y* Y Y Y Y Y
6.5 SP1 NA NA NA NA Y* Y* Y* Y Y Y Y
6.5 SP2 NA NA NA NA Y* Y* Y* Y* Y Y Y
6.5 SP3 NA NA NA NA NR NR NR NR NR NR NR
6.6 NA NA NA NA NA NA Y* Y* Y* Y* Y
5.3 SP6 NA NA NA Y NA NA NA NA NA NA NA
6 NA NA NA NA Y N N N N N N
6 SP1 NA NA NA NA Y* Y N N N N N
6.5 NA NA NA NA Y* Y* Y N N N N
6.5 SP1 NA NA NA NA Y* Y* Y* Y N N N
6.5 SP2 NA NA NA NA Y* Y* Y* Y* Y Y N
6.5 SP3 NA NA NA NR NR NR NR NR NR NR NR
6.6 NA NA NA NA Y* Y* Y* Y* Y* Y* Y
5.3 SP6 NA NA NA NR NR NR NR NR NR NR NR
6 NA NA NA NA Y N N N N N N
6 SP1 NA NA NA NA Y* Y N N N N N
6.5 NA NA NA NA Y* Y* Y N N N N
6.5 SP1 NA NA NA NA Y* Y* Y* Y N N N
6.5 SP2 NA NA NA NA Y* Y* Y* Y* Y N N
6.5 SP3 NA NA NA NR NR NR NR NR NR NR NR
6.6 NA NA NA NA Y* Y* Y* Y* Y* Y* Y
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6.5 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6.5 SP1 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6.5 SP2 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6.5 SP3 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NR NR NR NR NR NR NR NR
6.0 SPx NR NR NR NR NR NR NR NR
6.5 SPx NR NR NR NR NR NR NR NR
6.6 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 Y Y Y Y Y Y Y NR
6.0 SPx NA NA NA NA NA NA NA NR
6.5 SPx NA NA NA NA NA NA NA NR
5.3 SP6 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6 SP1 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6.5 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6.5 SP1 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
6.5 SP2 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NR
6.0 SPx Y Y Y Y Y Y Y NR
6.5 SPx Y Y Y Y Y Y Y NR
5.3 SPx NR NR NR NR NR NR NR NR
6.0 SPx NR NR NR NR NR NR NR NR
6.5 SPx NR NR NR NR NR NR NR NR
6.6 NA NA 6.6 NR NR NR NR NR NR NR NR
5.3 SP6 NA NA NA NA NA NA NA NA NA NA NR
6 NA NA NA NA NA NA NA NA NA NA NR
6 SP1 NA NA NA NA NA NA NA NA NA NA NR
6.5 NA NA NA NA NA NA NA NA NA NA NR
6.5 SP1 NA NA NA NA NA NA NA NA NA NA NR
6.5 SP2 NA NA NA Y Y Y Y Y Y NA NR
6.5 SP3 NA NA NA NA NA NA NA NA NA NA NR
6.6 NA NA NA NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP3 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.6 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP3 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.6 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NR NR NR NR NR NR NR NR
NA NA 6.0 SPx NR NR NR NR NR NR NR NR
NA NA 6.5 SPx NR NR NR NR NR NR NR NR
6.5 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP1 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP2 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.5 SP3 NA NA 6.6 Y Y Y Y Y Y Y Y
NA NA 5.3 SP6 NA NA NA NA NA NA NA NA
NA NA 6.0 SPx Y Y Y Y Y Y Y Y
NA NA 6.5 SPx Y Y Y Y Y Y Y Y
6.6 NA NA 6.6 Y Y Y Y Y Y Y Y
5.3 SP6 NA NA NA NR NR NR NR NR NR NR NA
6 NA NA NA NA Y NA NA NA NA NA NA
6 SP1 NA NA NA NA NA Y NA NA NA NA NA
6.5 NA NA NA NA NA NA Y NA NA NA N
6.5 SP1 NA NA NA NA NA NA Y Y NA NA N
6.5 SP2 NA NA NA NA NA NA NA Y Y Y NA
6.5 SP3 NA NA NA NR NR NR NR NR NR NR NA
6.6 NA NA NA NA N N Y* Y* Y* Y* Y
Global
DA CTS Registry Content Server
WebDAV Version Version Version 5.3 SP6 6 6 SP1 6.5 6.5 SP1 6.5 SP2 6.5 SP3 6.6
NA NA 5.3 SP6 Y Y Y Y NA NA Y NR
NA NA 6.0 SPx NA NA NA NA NA NA NA NR
NA NA 6.5 SPx NA NA NA NA NA NA NA NR
5.3 SP6 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NR
NA NA 6.0 SPx Y Y Y Y NA NA Y NR
NA NA 6.5 SPx Y Y Y Y NA NA Y NR
6 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NR
NA NA 6.0 SPx Y Y Y Y NA NA Y NR
NA NA 6.5 SPx Y Y Y Y NA NA Y NR
6 SP1 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NR
NA NA 6.0 SPx Y Y Y Y NA NA Y NR
NA NA 6.5 SPx Y Y Y Y NA NA Y NR
6.5 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NR
NA NA 6.0 SPx NA NA NA NA NA NA NA NR
NA NA 6.5 SPx NA NA NA NA NA NA NA NR
6.5 SP1 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NR
NA NA 6.0 SPx NA NA NA NA NA NA NA NR
NA NA 6.5 SPx NA NA NA NA NA NA NA NR
6.5 SP2 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NA NA NA NA NA NA NA NR
NA NA 6.0 SPx Y Y Y Y NA NA Y NR
NA NA 6.5 SPx Y Y Y Y NA NA Y NR
6.5 SP3 NA NA 6.6 NR NR NR NR NR NR NR NR
NA NA 5.3 SP6 NR NR NR NR NR NR NR NR
NA NA 6.0 SPx NR NR NR NR NR NR NR NR
NA NA 6.5 SPx NR NR NR NR NR NR NR NR
6.6 NA NA 6.6 NR NR NR NR NR NR NR NR
6 SP1 NA NA NA Y Y Y Y Y Y Y NA
6.5 SP2 NA NA NA Y Y Y Y Y Y Y NA
6.5 SP3 NA NA NA Y Y Y Y Y Y Y NA
6.6 NA NA NA NA NA NA NA NA NA NA NA
Note: The following specific notes are applicable to products listed in Table 11 with a Y**:
• If you install Content Server 6.5 SP3 or later and deploy Webtop and TaskSpace 6.5 SP2 or earlier,
you must perform the following tasks to ensure that the functionality in Webtop and TaskSpace
work properly:
Note:
— Set the value to TRUE to allow users to go forward to the next activity even if all performers
have not completed the activity.
— Set the value to FALSE to prevent users from going forward to the next activity until all the
performers have completed the current activity.
4. Repackage workflow.jar with the updated InboxResources.properties file.
5. Replace the existing workflow.jar file with the modified workflow.jar file in the
<Webtop_installation_directory>/WEB-INF/lib folder and/or <Taskspace_installation_
directory>/WEB-INF/lib.
6. Restart the application server.
Note: The following specific notes are applicable to products listed in Table 11 with a Y* or Y:
• When a later version of the Forms Builder, Process Builder, Process Integrator, or TaskSpace
client connects to an earlier version of Content Server, the Process Engine installed on Content
Server must be of the same version as the client.
• Queue management is not supported when using a Webtop 5.3 SP6 client against a 6.0 or 6.0 SPx
Content Server in which the 6.0 or 6.0 SPx BPM TBO has been installed.
• CIS 5.3 SP6 and 6.0 require the same version of Documentum Administrator. CIS 6.0 and 6.0 SPx
require Documentum Administrator 6.0 and 6.0 SPx, respectively.
• The upgrade of CIS to version 6 SP1 or 6.5 or later on DA 6, or upgrade of CIS to version 6.5
or later on DA 6 SP1 through 6.5 SP1 requires the update of the ci.jar file on Documentum
Administrator (DA).
• The upgrade of Federated Search Services requires the update of xtrim-api.jar on Webtop.
• Documentum Composer 6.5 or later on Content Server 6.5 or later can use the same or earlier
version of Content Server if the Composer DAR file does not include a feature that is not available
in that version of Content Server.
• Use the relevant Documentum Collaborative Services (DCS) 5.3 SP6 DocApps to upgrade a 5.3
SP6 installation or use the relevant DCS 6.0 and later DocApps/DARS to upgrade a 6.x installation
on the repository. Alternatively, as a first time user you must ensure that the Collaboration
Services.dar and DCS Attachments.dar have been installed on the repository before you
enable the DCS functionality for WDK-based applications. After the upgrade or installation
procedure, ensure that you enable DCS in Webtop by configuring custom/app.xml or using
Documentum Administrator.
• Ensure that the version of the Web Publisher application and the Web Publisher server files match
at any time. This also means that IDS/IDSx and Content Server are of the same version (there is no
such restriction on Web Publisher Server files version).
• Import Manager can use earlier or later versions of Content Server if the version of DFC for
the specific version of Import Manager is installed on the same server as Import Manager and
separate from Content Server.
• Physical Records Manager, Records Manager, and Retention Policy Services must be the exact
same version (6.5, for example) as each other when all are using the same repository. Similarly,
any other client (Webtop, for example) that interoperates with objects created by these products,
must be at the same version.
• Please see Records Manager, Physical Records Services and Retention Policy Services Release
Notes as certain functionality may not be present when using an earlier version of Content Server.
IRM Services for Documentum has different releases. The compatibility matrix for IRM services
for DCTM is available in Table 12.
Table 12. IRM Services for Documentum Compatibility against Content Server
100 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Interoperability and Compatibility
6.5 SP3 NA NA NA N N N N Y Y Y NA
(WIN-
DOWS,
SOLARIS
- SPARC)
6.6 (WIN- NA NA NA N N N N Y Y Y Y
DOWS,
SOLARIS
- SPARC,
LINUX
(IA-x86))
Since the Documentum Compliance Manager product was released for 5.3 SP4 and later for 6.0 and
later versions, Table 13 lists compatibility data specific to DCM only.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 101
Interoperability and Compatibility
5.3 SP6 N N N N N NA NA NA
6.0 SPx N N Y N N NA NA NA
6.5 SPx N N Y Y Y NA NA NA
Cross-product dependencies
Note: EMC recommends that you use DARs instead of DocApps whenever possible.
102 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Chapter 5
Migrating Content Server
If you are installing a new instance of Content Server 6.5 or later, and migrating data from a previous
version on a separate host, you need to follow a procedure somewhat different from an upgrade.
This chapter addresses any variation from the basic scenario to known issues surrounding the
configuration of your version 6.5 or later server.
• Rebuilding or upgrading fulltext indexes, page 104
• Configuring login tickets for backward compatibility, page 104
• Using DQL to migrate content to an XML Store, page 105
• Migrating custom Content Server methods, page 105
• Migrating DocApps and BOF2 modules, page 105
Migrating Content Server to 6.5 or later version occurs in three phases:
• Back up your existing data.
• Run the version 6.5 or later installer.
• Configure the new Content Server to use your existing repository.
These are the recommended steps for preparing and migrating your Content Server to version 6.5 or
later.
Table 15. Steps to migrate the Content Server to version 6.5 or later
Step Documentation
1. Back up your repository. Several third-party tools are available for
backup.
2. Clean up your repository. Documentum Administrator User Guide, Content
Repositories chapter, "Cleaning up repositories.”
3. Run the Consistency Checker utility. Documentum Administrator User Guide, Tools and
Tracing chapter, "Consistency Checker.”
4. Fix any errors identified by the Consistency
Checker.
5. Back up your cleaned, consistent repository.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 103
Migrating Content Server
104 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating Content Server
EMC Documentum System Version 6.6 Upgrade and Migration Guide 105
Migrating Content Server
If you want your upgraded BOF2 modules to be used by DFC 5.3 SP6 clients, you must perform the
following tasks:
1. Compile them for a Java 1.4.x target <javac target=1.4> to make them compatible with older
virtual machines.
2. Compile them against DFC 5.3 SP6 rather than DFC 6.0 or later to ensure they do not accidentally
reference new interfaces.
To migrate custom Business Objects in an environment of 5.3 SP6 clients that access a version 6.0 or
later Content Server, do the following:
• SBO
Install your 5.3 SP6 DocApps in the 5.3 SP6 global registry. Do not upgrade this global registry.
• Module or TBO
Make sure your code will work with DFC 5.3 SP6. It must compile with JDK 1.4.2 and must not
use any classes or methods that are new in DFC 6.0 or later.
106 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Chapter 6
Migrating DFC Customizations
The Documentum Java-Com Bridge (DJCB) and Primary Interop Assembly (PIA) are deprecated
from version 6.
The following topics describe how to migrate customizations of DFC to version 6.5 or later.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 107
Migrating DFC Customizations
Updating attributes of an object based on its location — Generally, you organize documents in a
meaningful folder hierarchy. You can also set one or more attributes on an object based on the
location in which it is imported or created. The BOF module contains a type-based business object
(TBO) that sets the attribute after the operation, based on the parent folder.
Attaching a lifecycle during a checkin operation — A service-based business object (SBO) can be
used to perform an operation after checkin, such as attaching a lifecycle. Other possible operations
include promoting a workflow or creating a rendition.
Search service
The DFC search service replaces prior mechanisms for building and running queries. You can use the
IDfQuery interface, which is not part of the search service, for simple queries.
The search service provides the ability to run searches across multiple Documentum repositories
and, in conjunction with the Documentum Federated Search Services (FS2) product, external
repositories as well. The Javadocs for the com.documentum.fc.client.search package describe how
to use this capability.
108 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating DFC Customizations
EMC Documentum System Version 6.6 Upgrade and Migration Guide 109
Migrating DFC Customizations
displayed in Documentum Administrator, which separates active settings (in DfPreferences) from
persistent settings (in dfc.properties).
DFC deployment
DFC is deployed with each application or product that requires it, using a standard J2EE deployment
strategy. In the J2EE deployment process, the dfc.jar file and related files are packaged in a product’s
WAR file so that each DFC instance can have its own DFC configuration.
110 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Chapter 7
Migrating WDK and Webtop
Applications
The following topics describe how to migrate your customizations to WDK or Webtop 6.6:
• Overview, page 111
• Updating and migrating email messages, page 112
• Java class changes, page 113
• Application framework changes, page 113
• Application-wide changes, page 120
• Content transfer changes, page 149
• Style changes, page 154
• Feature changes, page 155
The migration topics are ordered by release version, with the latest release changes first.
Overview
Deploy and configure applications based on WDK or Webtop 6.5 or later on an application server
instance different from your existing installation and then migrate any customizations to the 6.5 or
later deployment. Do not migrate any of your existing customizations that new functionality in a
6.5 or later version can replace. To enable full 6.5 or later functionality, you must also upgrade the
DocApps/DARs in the repositories (including global registries) that your WDK application accesses.
For more information, refer to Chapter 5, Migrating Content Server.
Effort estimates are based on the average time to perform a configuration (simple effort, measured in
hours) or a custom class (complex effort, measured in days). For multiple customizations of the same
type, multiply the effort estimate by the number of customizations to migrate. For example, if you
have five custom actions for which to add shortcuts, you multiply the simple effort times 5. It is hard
to give an exact time estimate, because it is based on your engineers’ familiarity with WDK and the
scripting or programming tasks required to perform the configuration or customization.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 111
Migrating WDK and Webtop Applications
112 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
The following features have been enhanced to support the EMCMF format:
• Import: When a user imports an email message (.msg), the email message converts to EMCMF
format and is stored as a dm_message_archive type. All attachments in the email are imported
and related to the email.
• Export: When a user exports an EMCMF object, the object converts to native email format (.msg)
for viewing by Microsoft Outlook.
• View Properties and Listing pages: The Properties and Listing pages have been enhanced to show
email-centric attributes such as To, From, Date Sent and Subject.
• Transform: EMCMF messages can be transformed to HTML, XML, or PDF.
Existing email messages of the dm_email_message object type (and its subtypes) and the msg format
must be migrated to the dm_message_archive type (EMCMF) or one of its subtypes. In addition,
since 6.5, the dm_message archive message_id attribute has been lengthened from 24 to 42 characters.
EMC Documentum provides utilites to perform the migration of dm_email_message objects to
dm_message_archive objects. For instructions on running these utilities, refer to Webtop Email
Migration Guide.
Autofocus — The form tag has an attribute "autofocusneeded” that causes the first focusable control
on the page to receive focus. By default this attribute value is false, since all forms in a multi-frame
EMC Documentum System Version 6.6 Upgrade and Migration Guide 113
Migrating WDK and Webtop Applications
view cannot have focus. Set to true for the frame that should receive focus. For example, in Webtop
the JSP page app_general_preferences_ex.jsp calls for autofocus, so that when the preferences
component is launched from the titlebar component, the general preferences tab receives focus:
<dmf:form autofocusneeded=’true’>
Enhanced control labels — When a control receives focus, the tooltip or tooltipnlsid attributes
render the HTML title attribute. If this information is not sufficient for the screen reader, additional
context can be provided by a label tag that is associated with the control that needs context. Specify
the label using the associatedcontrolid attribute on the context control. In the following example, a
label control specifies the text for which it provides information:
<dmf:label nlsid="MSG_NAME" associatedcontrolid="object_name"/>
<dmf:text id="object_name" tooltipnlsid="MSG_NAME_DESCRIPTION"/>
Radio, link, datasortlink, datadropdownlist, and checkbox controls can also have a prefix and/or
postfix label to provide context. For these controls, the prefix or postfix label is specified as an
attribute on the control itself. In the following example, each radio control specifies a prefix label that
provides additional context:
<dmf:label nlsid="MSG_APPLICATION"/>
<dmf:radio nlsidid="MSG_APP_1" prefixassociatedlabelnlsid="MSG_APPLICATION_1"
NAME="app1" GROUP="theme"/>
<dmf:radio nlsidid="MSG_APP_2" prefixassociatedlabelnlsid="MSG_APPLICATION_2"
NAME="app2" GROUP="theme"/>
Note: The context label associated with a control will override any tooltip or tooltipnlsid setting.
The sortablelistbox control has three tooltips for the Up, Down, and Remove buttons that enhance
accessibility.
Datagrid row information — The actions link in a datagrid row can describe possible actions. You
can configure which information about the object in the row is displayed. By default, the object name,
data type, and lock status are added to the title of the actions link in that row. Other columns can be
added using the columnsforaccessibility attribute of datagridRow tag. In the following example, the
name is displayed instead of the object name:
<dmf:datagridRow ... columnsforaccessibility="name">
114 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
You can exclude pages from displaying a timeout warning in the <timeout_exclude_list> element. In
the following example, the login page is excluded:
<session_config>
<timeout_control>
...
<timeout_exclude_list>
<exclude>
</exclude>
</timeout_exclude_list>
</timeout_control>
</session_config>
EMC Documentum System Version 6.6 Upgrade and Migration Guide 115
Migrating WDK and Webtop Applications
customization can be accomplished using presets. Presets offer significant benefits in terms of
flexibility and maintainability.
Presets are limited to those that can be defined in the presets editor UI. Presets should not a used to
set security or access to objects. For information on using presets, see the Webtop User Guide.
A new UserQualifier was added to webtop/app.xml to support presets targeted to individual users.
116 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
</scope>
For full details on extending and modifying configuration files, refer to Web Development Kit and
Client Applications Development Guide.
The menu configuration file for this menu has an id that matches the configid attribute on the menu
tag. In the following configuration file, two menus are defined: my_menu and 222_menuconfig. The
second menu is included as a submenu within the top-level menu:
<config>
<scope>
<menuconfig id=’my_menu’>
<menuitem name=’aaa’ label=’Do A’/>
<menu id=’111’ name=’111’ label=’B menu’>
<menuitem name=’b1’ label=’Do B1’ onclick=’event_handler’/>
<actionmenuitem name=’b2’ label=’Do B2’ action=’some_action’/>
</menu>
<menuconfig id=’222_menuconfig/>
</menuconfig>
<menuconfig id=’222_menuconfig’>
<menu id=’222 name=’222’ label=’C menu’>
<menuitem name=’ddd’ label=’Do C’/>
</menu>
</menuconfig>
</scope>
</config>
The <menuconfig> element defines a menu that can be included within another <menuconfig> or
referenced in a JSP page. In the example above, an empty <menuconfig> element is used to include
EMC Documentum System Version 6.6 Upgrade and Migration Guide 117
Migrating WDK and Webtop Applications
the ’C menu’ within the top-level ’my_menu’. The ’C menu’ can also be used separately in another
component because it is in a <menuconfig> element.
The elements in a menu configuration file, except the <menuconfig> element, generate JSP tags
with the same name. Attributes on the configuration element are generated as attributes on
the tag. For example, <menuitem name=’file_help’ nlsid=’MSG_HELP’ onclick=’onClickHelpr’
runtatclient=’true’/> generates the JSP tag <dmf:menuitem name=’file_help’ nlsid=’MSG_HELP’
onclick=’onClickHelp’ runatclient=’true’/>. Just as for JSP tags, the nlsid key overrides a hard-coded
label in the label attribute. NLS values are retrieved from the nls bundle of the component that
contains the menu. If the menu item keys are not found in the bundle, then they are retrieved from
the menu NLS bundle specified in custom/app.xml as the value of <menu>.<nlsbundle>.
Table 16, page 118 describes the elements in a menu configuration file that can be used to generate a
menu.
Element Description
<menuconfig> Defines a top-level menu. Contains at least one
<menu> or <menuconfig> element. Has an id
attribute that is used to include the menu into
another menu or a JSP page.
Menus can be extended and modified using the WDK configuration mechanism. Refer toWDK
Development Guide for information on how to extend a menu configuration or how to insert, remove,
or override a menu item.
118 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
Tip: If you are reusing a menu in more than one component, put the menu into a <menuconfig>
element. If you are making simple modifications to a WDK menu you will not be reused in other
components, insert menu elements into the <menuconfig> element or its child elements using the
modification mechanism. In the following example, the sample menu above is modified by inserting
a menu item labeled Do X between Do B1 and Do B2.
<menuconfig modifies="my_menu:custom/config/mycomponent.xml">
<insertafter path="menu[id=111].menuitem[name=b1]">
<menuitem name="xxx" label="Do X" onclick="do_something"/>
</insertafter>
</menuconfig>
EMC Documentum System Version 6.6 Upgrade and Migration Guide 119
Migrating WDK and Webtop Applications
<id>menubar_view_menu</id>
<id>menubar_tools_menu</id>
<filter entitlement="recordsmanager">
<id>menubar_rpm_menu</id>
</filter>
</menuconfigids>
The following example in a custom menubar component definition modifies the menu to add a
menu item at the end:
<component id="menubar" modifies="menubar:webtop/config/menubar_component.xml">
<insert path=’menuconfigids’>
<id>menubar_mymenu</id>
</menuconfigids>
</component>
Application-wide changes
The following topics describe features that appear in many places in the application. You can change
the support for these features by configuration, as described in each migration topic.
120 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
Prerequisites
• Deploy Webtop on the application server machine that is in the Kerberos domain, and connect to
Content Server that is also in the Kerberos domain. For more information, see the Web Development
Kit and Webtop Deployment Guide.
• Install IE 6 or IE7 or IE8 or Firefox 2.x or Firefox 3.0.x or Firefox 3.5.x on the client and application
server.
• Register Webtop as a Service Principal in the Key Distribution Center (KDC). For more
information, see the Web Development Kit and Webtop Deployment Guide.
Carry out the configurations specified in this section, in the <enabled>, and <domain> tags within the
<authentication> tag.
An application level setting is provided in wdk/app.xml within the <authentication> tag to enable or
disable Kerberos-based SSO authentication. The default value defined for the <enabled> tag in the
<kerberos_sso> element is "false". Set the <enabled> tag to true to enable Kerberos SSO authentication.
<kerberos_sso>
<enabled>true</enabled>
</kerberos_sso>
An application level tag is provided to specify the Kerberos domain, within the <authentication> tag.
Enter the domain name in the <domain> tag.
<kerberos_sso>
<domain><domain_name></domain>
</kerberos_sso>
The Kerberos SSO Authentication Scheme provides the option to fall back to the default login
mechanism to the web-application, on failure conditions. Set the <docbase_login_fallback> tag in the
<kerberos_sso> tag in wdk/app.xml, to support the default login to the web-application, as follows:
<docbase_login_fallback>true</docbase_login_fallback>
EMC Documentum System Version 6.6 Upgrade and Migration Guide 121
Migrating WDK and Webtop Applications
The following code snippet is an example of the final configuration for Kerberos in app.xml.
Example 7-1. Code snippet in the wdk/app.xml file to enable Kerberos authentication
<authentication>
<!-- Kerberos SSO authentication scheme configuration -->
<kerberos_sso>
<enabled>true</enabled>
<browsers>
<windows>
<ieversions>6.0,7.0,8.0</ieversions>
<firefoxversions>2.0,3.0,3.5</firefoxversions>
</windows>
</browsers>
<!-- Enable login fall back to DocbaseLogin scheme -->
<docbase_login_fallback>false</docbase_login_fallback>
<!-- Mandatory configuration: Provide the kerberos realm / domain name. -->
<domain>WDKBLR.COM</domain>
</kerberos_sso>
</authentication>
Copy the <authentication> tag from the wdk/app.xml file in to the custom/app.xml file.
For more information about enabling Kerberos Authentication, see the Web Development Kit and
Webtop Deployment Guide.
Implementing rowIterator() — This method returns an iterator over the rows and can be used to
return selected rows of a datagrid.
122 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
The syntax of the DRL after enabling the <resolve-deleted-DRL> parameter in WDK/app.xml is
as follows:
http://host_name:port/app_name/component/drl/objectId/xxx/chronicleId/xxx
Disabling modal pop-up dialogs — Modal pop-up dialogs are enabled by default. They can be
disabled in app.xml by setting the <enabled> element to false:
<modalpopup>
<filter clientenv=’webbrowser’>
<enabled>false</enabled>
</filter>
...
</modalpopup>
EMC Documentum System Version 6.6 Upgrade and Migration Guide 123
Migrating WDK and Webtop Applications
Modal pop-up windows are defined in app.xml within each <theme> element. The
<theme>.<windowsizelist> element contains one or more windows defined by three child elements:
<name>, <width>, and <height>, the latter two in pixels. For example, the small window is defined
as follows:
<windowsize>
<name>small</name>
<width>400</width>
<height>330</height>
</windowsize>
124 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
linkTag.addEventArg("refreshparentwindow", refreshParentWindow);
Invoking a modal component to edit attributes — Editing components for attributes can be
launched in a modal pop-up dialog. Specify the modality in the docbaseobjectconfiguration file. In
the following example, the versionlabels editor for the version label attribute is launched modally:
<attribute name="r_version_label">
<valuehandler>com.documentum.web.formext.control.docbase.
DocbaseAttributeVersionLabelSetValueHandler
</valuehandler>
<editcomponent>versionlabels</editcomponent>
<invocation>
<modalpopup>
<windowsize>small</windowsize>
<refreshparentwindow>onok</refreshparentwindow>
</modalpopup>
</invocation>
</attribute>
You can also specify multiple modal pop-up window sizes in app.xml. Compare your custom
components to the corresponding 6.5 components to determine whether you want to include the
modal pop-up dialog elements in your custom component.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 125
Migrating WDK and Webtop Applications
There are three options for refreshing the parent window. The refresh setting can be specified within
the action definition or event handler argument. Use one of the following settings:
• always
The framework always refreshes the parent window when the child window is closed.
• onok
The framework refreshes the parent window when the child window is closed and the return
value is not null. If the user cancels the modal dialog, no refresh occurs. The component developer
must ensure that there is a return value when the component closes.
• never
The framework never refreshes the parent window when the child window is closed.
In the example of the view action, the action and postprocessor class are as follows:
<postprocessor id="viewvdm" action="view" class="
com.documentum.web.formext.action.ViewActionInvocationPostProcessor"/>
The postprocessor class implements IActionInvocationPostProcessor and checks whether the object
is a virtual document. If so, it overrides the modal behavior for the view, which was defined in
the view action definition:
public ModalPopupProperties getModalPopupProperties(
ModalPopupProperties modalPopupProp,
ActionService.ActionDef actionDef, ArgumentList itemArgs)
{
boolean useModalPopup = actionDef.getUseModalPopup();
if (itemArgs != null)
{
if ("view".equals(actionDef.getActionId()) && isVirtualDoc(itemArgs))
{
useModalPopup = false;
}
}
return new ModalPopupProperties(
useModalPopup,modalPopupProp.getModalPopupWindowSize(),
126 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
modalPopupProp.getRefreshParentWindow());
}
If your component executes the JavaScript function window.location.replace() API in a modal popup
window, then you must change it to call navigateToURL(), a function in modal.js. For example, the
loginRedirect JavaScript event handler in the timeout.jsp page of Webtop reloads the login page
as follows:
function loginRedirect()
{
...
var strUrl = addBrowserIdToURL(g_virtualRoot+"/component/main");
navigateToURL(strUrl, "timeout", targetWindow);
...
}
Change the ticket timeout (minutes) to a setting appropriate for your network throughput.
When you enable IRM, Webtop displays an extra tree node called Rights Management under the
repository node. Some IRM-specific menus for IRM protection and profiles are also displayed.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 127
Migrating WDK and Webtop Applications
Documentum Composer User Guide. After the upgrade or installation procedure, ensure that you
enable DCS in Webtop by configuring wdk/app.xml. DCS can be enabled or disabled in Webtop by
modifying wdk/app.xml of your WDK application with the configuration described in this section. By
default, the DCS feature is disabled in the Webtop application. However, the performance of Webtop
may be impacted marginally after enabling DCS because Webtop will include the extra functionality.
Note: The DCS distribution also contains the collaboration.jar file. This JAR file contains
interface classes for users who want to write custom applications using DCS. This JAR file is not used
for standard deployments.
128 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
emfimport is a new component in the import container. If you have customized the import
container, add this component to your custom importcontainer definition.
• Export (for example,
export (type dm_message_archive) is a new action. Requires no migration.
• View Properties and Listing pages
The attributes of type dm_message_archive are displayed. Requires no migration.
• Search
Search for type dm_message_archive are supported. Requires no migration.
Controls that refresh inline — Four controls have a new inlinerefresh attribute: tree and
showhide in dmform_1_0.tld and docbaseattributelist and multiobjectsdocbaseattributelist in
dmformext_1_0.tld. Refresh can be turned off by setting this attribute value to false in the JSP page
(default is true).
Turning off inline refresh of the Webtop browser tree — The browsertree (version 6.0) Webtop
component is a new component, defined in webtop/config/browsertreex_component.xml.
jumpToBrowserTreeLocationAction is a new action related to this feature. Custom browsertree
components should extend the browsertree component in webtop/config/browsertreeex_component.
xml (new file).
You can turn off inline refresh by modifying classic.jsp in webtop/classic. Change from true to false
in the following line:
String strBrowsertreeArgs = "?inlineRefresh=true";
Using the new showhide control — The showhide control, new in WDK 6.5, can replace existing
refresh features. For example, extendedpermissions.jsp in 5.3 used a link to reload the page when the
user clicked the link:
<!--restrictions show/hide-->
...
<dmf:link name=’<%=ExtendedPermissions.RESTRICTIONS_PERMIT_IMAGE%>’
onclick=’onShowOrHideRestrictions’
tooltipnlsid=’MSG_SHOW_RESTRICTIONS_TIP’/>
<dmf:link name=’<%=ExtendedPermissions.RESTRICTIONS_PERMIT_LINK%>’
onclick=’onShowOrHideRestrictions’ cssclass=’showMoreHideMoreLink’
tooltipnlsid=’MSG_SHOW_RESTRICTIONS_TIP’/>
In WDK 6.5, the links are replaced with a faster refresh through the showhide control:
<dmf:showhide name=’restrictions_showhide’
EMC Documentum System Version 6.6 Upgrade and Migration Guide 129
Migrating WDK and Webtop Applications
panelname=’<%=ExtendedPermissions.RESTRICTIONS_PANEL%>’
shownlsid=’MSG_SHOW_RESTRICTIONS’
hidenlsid=’MSG_HIDE_RESTRICTIONS’
showtooltipnlsid=’MSG_SHOW_RESTRICTIONS_TIP’
hidetooltipnlsid=’MSG_HIDE_RESTRICTIONS_TIP’/>
The showhide control is associated with a panel control that is displayed when the user clicks Show.
Specify the name of the associated panel in the panelname attribute of the showhide control.
Displaying LWSO shared parent — To turn on the display of shared parents is listing and locator
pages, add the following lines to your custom app.xml file:
<lightweight-sysobject>
<hide-shared-parent>false</hide-shared-parent>
</lightweight-sysobject>
130 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
2. For Java EE principal authentication, paste the encrypted form of the password into the file
TrustedAuthenticatorCredentials.properties located in WEB-INF/classes/com/documentum/web/
formext/session. Each repository must have an entry for the superuser, encrypted password, and
domain if needed. Substitute the actual repository name in the sample entries below. If no
domain is needed for login, then type the following: Repository_name.domain=
Repository_name.user username
Repository_name.new‑pw password
Repository_name.domain domainname
For example:
mydocbase.user=superuser1 mydocbase.newpw= d7d1d6e383d6d4e1d0 mydocbase.domain=
3. For preferences or presets repository passwords, paste the encrypted form of the password
into the file app.xml in the custom directory. Insert the encrypted preferences password
into <preferencesrepository>.<password> or the encryped presets password into the
<presets>.<password> element.
4. The symmetric keys for encryption and decryption are stored in a file named
wdk.keystore. This file must be stored in a secure location on the application
server file system. Open the file KeystoreCredentials.properties, located in
WEB-INF/classes/com/documentum/web/formext/session, and specify your keystore location.
You must also override the use of the default DFC config dir in order to substitute this
new location, for example: keystore.file.location=C:/Documentum/config/wdk.keystore
use_dfc_config_dir=false
EMC Documentum System Version 6.6 Upgrade and Migration Guide 131
Migrating WDK and Webtop Applications
By default, the keystore file location is created in the DFC config directory, which contains
dfc.properties and is specified as the value of dfc.config.dir in dfc.properties. The default location
is WEB-INF/classes.
Note: Entries that were encrypted by the 5.3.x encryption tool and entered into the field .password
instead of the .new-pw field will be decrypted by the 5.3.x encryption tool.
The WDK samples and testbed have been removed from the application to prevent cross-site
scripting. These files are available as a separate download on the download site.
Enabling change notification — Users can request change notification for a Content Server event on
one or more objects. Any API, workflow, or lifecycle event can be notified. Notification is available on
dm_sysobject and its subtypes from the Webtop menu or the right-click context menu. Notification
on replica and reference (shortcut) objects is not supported. The user who has selected change
notification on an object will receive a notification in the Documentum inbox, and by email. If an
event that is configured in app.xml does not exist in a particular repository, that event is ignored by
the event notification mechanism for users who are logged into that repository.
Add notification for an event by copying the entire <notification> element from
webcomponent/app.xml to your custom app.xml and adding an <event> element for each notifiable
element. Server events are listed in an appendix of Documentum Administrator User Guide.
Enabling read notification — A user can select any object in a list view and turn on read notification
to notify the user when the document has been read. The default event for notification is dm_getfile,
and the minimum permission for read notification is configured in app.xml.
Add notification for read access to objects by copying the entire <readnotification> element from
webcomponent/app.xml to your custom app.xml and specifying the name of the read event (default
dm_getfile) and the minimum permission required to request read notification. Server events are
listed in an appendix of Documentum Documentum Administrator User Guide.
132 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
wrong context. You can specify the precedence in which roles should be evaluated for a user. In the
following example, role abc takes precedence over role def if a user is assigned both roles.
<rolesprecedence>
<role>abc</role>
<role>efg</role>
</rolesprecedence>
Copy the entire <rolemodel> element from /wdk/app.xml to your custom app.xml and add your
appropriate rolesprecedence element.
Turning off new datagrid features — The new datagrid features can be reverted with the following
addition to your custom app.xml:
<desktopui>
<datagrid>
<richui>false</richui>
</datagrid>
</desktopui>
Placing content below the datagrid — A datagrid without a height attribute value will span
the entire height of the window. If you have content to place below the datagrid, put it within a
dmf:datagridFooter tag within a dmf:datagridRow tag.
The following topics describe migrating your custom components to use the new datagrid features.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 133
Migrating WDK and Webtop Applications
Replacing <td> with <datagridRow> — Every <td> tag within the custom datagrid dmf:datagridRow
tag must be replaced with dmf:datagridRowTd tag. For example, in the 5.3 page acllist.jsp, the
description column in the datagrid is as follows:
<td class="doclistfilenamedatagrid">
<dmf:label datafield=’description’/>
</td>
Handling a double-click event in a datagrid row — If your datagrid row supported a link
event (single or double click), you must either migrate the link to a right-click context menu or
to a datagridRowEvent tag. The following example wraps a WDK 5.x double-click event with a
datagridRowEvent. The event arguments, which in 5.x were passed in the actionmultiselectcheckbox,
are passed in argument tags:
<dmf:datagridRowEvent eventname=’dblclick’ eventhandler=’
onClickObject’ runatclient=’true’>
<dmf:link onclick=’onClickObject’ name=’
objectLink’ runatclient=’true’ datafield=’object_name’>
<dmf:argument name=’id’ datafield=’r_object_id’/>
<dmf:argument name=’type’ datafield=’r_object_type’/>
<dmf:argument name=’isFolder’ datafield=’isfolder’/>
</dmf:link>
</dmf:datagridRowEvent>
Handling a single-click event (selection) in a datagrid row — The following example handles a
single-click event (selecting the row). The event handler for a select event must be client-side:
<dmf:datagridRowEvent eventname=’select’ eventhandler=’
onSelectObject’ runatclient=’true’>
<dmf:argument name=’id’ datafield=’r_object_id’/>
<dmf:argument name=’name’ datafield=’object_name’/>
</dmf:datagridRowEvent>
The event object that is passed to the JavaScript handler has the following properties:
• type
Event type, such as select or init
• datagrid
Datagrid object instance
• startIndex
134 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
Turning off row selection per datagrid — You can turn off row selection for an individual datagrid
by setting the rowselection attribute value to false on the datagrid control in a JSP page. The app.xml
file’s <desktopui>.<datagrid>.<richui> element must be set to true to enable this attribute. The
following table describes the interaction between the global row selection flag in app.xml and the
datagrid attribute rowselection attribute.
Table 17. Interaction between global versus local row selection settings
EMC Documentum System Version 6.6 Upgrade and Migration Guide 135
Migrating WDK and Webtop Applications
If your listing component extends the DocList component, it inherits support for resizeable
columns. If not, you must add the initColumnWidths method to the implementation of
the component class and call it when the component initializes. Your class must import
DatagridColumnWidthPreferenceHelper:
...
import
com.documentum.web.form.control.databound.DatagridColumnWidthPreferenceHelper;
...
public void onInit(ArgumentList args)
{
. . .
initColumnWidths();
}
Headings now stay in place while the user scrolls through the items in the datagrid. To enable this
behavior, custom components must implement header rows using the new element datagridTh. For
example, in the 5.3 component acllist, the datagrid contains a header for the name column:
<th align=’left’ scope=’col’ class="doclistfilenamedatagrid">
<b>
<dmf:datasortlink name=’sortcol1’ nlsid=’MSG_NAME’ column=’
object_name’ mode=’caseinstext’ cssclass=’doclistbodyDatasortlink’/>
</b>
</th>
To globally disable fixed column headers in the application, add the following element to
/custom/app.xml:
<desktopui>
<datagrid>
136 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
<fixedheaders>false</fixedheaders>
</datagrid>
</desktopui>
Context menus are defined in the <menuconfig> element of an action configuration file for a specific
object type. For example, the configuration file dm_folder_actions.xml contains the menu items that
are available for folder (the dm_folder type). The element <actionmenuitem> identifies an action that
can be performed on the object type . You can create submenus within the <menuconfig> element by
nesting a <menu> element with its own <actionmenuitem> elements.
The following example from dm_folder_actions.xml defines a context menu for actions on selected
dm_folder objects. The Properties menu item is followed by a View submenu that contains
three actions: relationships, locations, and topics. Note that some actions support multiple
selection (the dynamic attribute is set to "multiselect") and some support only single selection
(dynamic="singleselect").
<menuconfig id="contextmenu">
<actionmenuitem dynamic="multiselect" action="
subscribe" .../>
<actionmenuitem dynamic="multiselect" action="
unsubscribe" .../>
...
<menuseparator/>
<actionmenuitem dynamic="singleselect" action="
properties" .../>
...
<menu menu nlsid="MSG_VIEW_MENU">
<actionmenuitem dynamic=’multiselect’ action=’
relationships’ .../>
<actionmenuitem dynamic=’multiselect’ action=’
locations’ .../>
<actionmenuitem dynamic=’multiselect’ action=’
showtopicaction’ .../>
</menu>
</menuconfig>
You could add a custom menu item to the top level menu and one to the View menu as follows:
<menuconfig id="contextmenu">
<actionmenuitem dynamic="multiselect" action="
EMC Documentum System Version 6.6 Upgrade and Migration Guide 137
Migrating WDK and Webtop Applications
subscribe" .../>
<actionmenuitem dynamic="multiselect" action="
unsubscribe" .../>
...
<menuseparator/>
<actionmenuitem dynamic="singleselect" action="
properties" .../>
<actionmenuitem dynamic="singleselect" action="
firstcustomaction" .../>
...
<menu menu nlsid="MSG_VIEW_MENU">
<actionmenuitem dynamic=’multiselect’ action=’
relationships’ .../>
<actionmenuitem dynamic=’multiselect’ action=’
locations’ .../>
<actionmenuitem dynamic=’multiselect’ action=’
showtopicaction’ .../>
<actionmenuitem dynamic=’singleselect’ action=’
nextcustomaction’ .../>
</menu>
</menuconfig>
to
String strRows = "22,*";
138 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
The hotkeyid value is resolved by a lookup in the shortcuts (hotkeys) definition in hotkeys.xml.
This file defines an NLS key for each hotkey ID. The key is then resolved to a key combination
in the hotkeys properties file HotKeysNlsProp.properties. The properties files can be localized
for locale-specific key combinations.
Caution: When focus is on a user-entry control such as text, shortcuts are not enabled. If you
set initial focus in the UI to a user-entry control, shortcuts will not be enabled until the user
moves off the control.
The <hotkeys> element in your custom app.xml file specifies a mapping file that maps key
combinations to actions. You must specify the location of your properties file in your custom app.xml.
If your file is located in WEB-INF/com/mycompany, for example, you would specify the location in
an <nlsbundle> element as follows in app.xml:
<hotkeys>
<enabled>true</enabled>
<nlsbundle>com.mycompany.HotKeysNlsProp</nlsbundle>
</hotkeys>
EMC Documentum System Version 6.6 Upgrade and Migration Guide 139
Migrating WDK and Webtop Applications
The hotkeyid value for a control is resolved by a lookup in the hotkeys configuration file hotkeys.xml,
located in webcomponent/config. The corresponding key NLSID value is resolved by a lookup
in a shortcut mapping file.
Tip: If you are changing existing shortcut combinations, you do not need a hotkeys definition file. If
you are adding shortcuts for your custom actions or removing shortcuts to WDK actions, a hotkeys
definition XML file is required. You can use the modification mechanism to do this.
Element Description
<hotkeys id=...> The id attribute on this element facilitates more
than one hotkeys definition for the application
<hotkey id=...> The id attribute on this element is referenced by
a control on the JSP page and contains a key for
lookup of the hotkey combination. The ID must
be unique to the definition. Contains <keynlsid>
and, optionally, <labelnlsid>.
<keynlsid> Specifies an NLS key that is resolved in the
hotkeys NLS properties file.
<labelnlsid> (Optional) Specifies an NLS key for a label that
to be displayed for the shortcut
140 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
A Java NLS properties file specifies the key combinations for each hotkey ID. Make sure your custom
app.xml file specifies the fully qualified path name for this NLS properties file as described in
Specifying a shortcuts mapping properties file, page 139. If you add shortcuts to custom actions, then
create NLS IDs for your shortcut IDs in a custom hotkeys configuration file as described in Adding
a shortcut definition in an XML file, page 140.
To include the WDK or Webtop shortcuts — When you change or add hotkey combinations,
include the WDK properties file in your own properties file so that you inherit the WDK shortcuts.
Include the WDK map as follows:
NLS_INCLUDES=com.documentum.webcomponent.keyboardshortcut.HotKeysNlsProp
To add a new shortcut combination — Add a new shortcut similar to the following, which specifies
that the shorcut with the NLS id _#HOTKEY_CUSTOM_ACTION maps to the keystrokes Ctrl and
Shift and X:
_#HOTKEY_CUSTOM_ACTION=Ctrl+Shift+k
To modify an existing shortcut — In your custom mapping properties file, add an entry for the
shortcut with the keystroke combination. This entry will override the entry in the WDK mapping file.
The following example changes the keyboard shortcut for Export from Shift + E to Shift + X:
_#HOTKEY_EXPORT=Shift+X
In your key combinations, a single keyboard key can be combined with another key such as Ctrl
(Windows), Cmd (Macintosh), Shift, or Alt. Table 19, page 141 describes the single keys that can be
used in a shortcut combination. Shortcut definitions are case-insensitive.
Key Description
alphanumeric A-Z or 09
navigation and command Home, End, Enter, Insert
punctuation The following punctuation keys can be used:
; = , . / ’ [ ] \ ‘
function keys Unreserved function keys are valid
Tip: Do not use a shortcut combination that is reserved for browsers, such as Ctrl+c for copy in IE.
WDK will not attempt to override reserved shortcuts.
The NLS ID value that is used to specify the shortcut combination can have .MAC added to provide
an alternate shortcut combination for the Macintosh platform, for example:
_#HOTKEY_COPY_FILE=Shift+V
_#HOTKEY_COPY_FILE.MAC=Shift+C
EMC Documentum System Version 6.6 Upgrade and Migration Guide 141
Migrating WDK and Webtop Applications
1. Add your NLS bundle reference to app.xml in your custom directory, for example:
<hotkeys>
<nlsbundle>com.mycompany.HotKeysNlsProp</nlsbundle>
You will create this file in step 6.
2. Create a file hotkeys_modification.xml in custom/config and open the file for editing.
3. Add the required XML structure:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<config>
<scope>
</scope></config>
5. Within the insert element, add <hotkey> elements for the new shortcut. You do not need to
modify the definition to replace a shortcut, because you can use the same keynlsid and just
provide a new string in the properties file.
<insert>
<hotkey id="HOTKEY_MYACTION">
<keynlsid>_#HOTKEY_MYACTION</keynlsid>
</hotkey>
</insert>
<replace>
7. Add the hotkeyid attribute value HOTKEY_MYACTION to the component JSP page, in the
control that calls your custom action, for example:
<dmfx:actionlink name="mylink" action="myaction" hotkeyid="HOTKEY_MYACTION"...>
8. Restart the application server for changes to NLS properties files. If your changes are to XML
files only, refresh memory by navigating to wdk/refresh.jsp.
9. Test your shortcut combination in the appropriate component.
Shortcuts are bound to the top level window of the application, so you must ensure that all shortcuts
are uniquely defined in the <hotkeys> configuration elements across your application. This will be
easier to manage in a single shortcuts mapping file. If two controls are assigned the same shortcut, the
second assignment will be used. Shortcuts are not invoked when the keyboard focus is on an input
field such as text, textarea, or password. For these controls, use the escape key to access shortcuts.
142 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
In every JSP page that contains your custom control, you must add the new shortcutid attribute. In
the following example, the custom action has a shortcut with the ID HOTKEY_CUSTOM_ACTION,
as defined in the properties mapping file:
<mytld:customactions name="customactiona" dynamic="singleselect" action="
action1" hotkeyid="HOTKEY_CUSTOM_ACTION1" .../>
The base Control class supports shortcuts with the public methods setHotKey, setHotKeyLabel,
getHotKey, and getHotKeyLabel. The following WDK controls support shortcuts: ActionMenuItem,
ActionButton, ActionLink, ActionImage, Button, Link, and MenuItem.
If your custom control extends a WDK control with shortcut support, add the hotkeyid attribute to
the tag library descriptor that contains your control and then set the hotkeyid value on the control
in the JSP page.
To set a shortcut combination programmatically on a control that supports shortcuts, use the API
setHotkey(String hotKey) where the parameter is a key combination, for example: setHotkey("alt+x");
If your control does not extend a control with shortcut support, add support to the tag class by calling
either the renderHotKey() or renderHotKeyHandler() from renderEnd().
The keyboard events that are handled are keyup, keydown, and keypress. WDK JavaScript handlers
for each of these keyboard events retrieve the shortcut commands and invoke the corresponding
actions.
2. At the end of renderEnd() in the control tag class, add a call to renderHotKey() or
renderHotKeyHandler().
• For a control that launched as client JavaScript event, for example, a click, call
renderHotKey(StringBuffer buf, String eventName) and provide the event name, for example,
onClick. The Javascript code for the shortcut will be rendered by the framework.
The following example from ButtonTag checks whether the control is enabled and, if so,
adds the renderHotKey JavaScript function key to the output. In the Button class, the
EVENT_ONCLICK is the onclick event:
if (button.isEnabled())
{
StringBuffer buf = new StringBuffer(256);
renderHotKey(buf, Button.EVENT_ONCLICK);
out.print(buf.toString());
EMC Documentum System Version 6.6 Upgrade and Migration Guide 143
Migrating WDK and Webtop Applications
144 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
Tab ordering is enabled by default. Tab ordering can be turned on or off for different environments in
app.xml. We recommend that you turn off tab ordering in portal applications.
When a component is included within another component, elements may have the same tabindex
value. Place the included component in the page based on your preferred tab ordering among the
elements in the parent page. WDK will ensure that tabindex collisions are resolved and elements
are navigated in the order they appear in the character stream.
Tip: As a general rule, you should assign index values incrementally based on the order of elements
in the source code for the page. Use the tab key ordering to support a different tabbing requirement.
Do not use tab ordering to "fix" a bad page design. In the latter case, alter the order of the content
in the markup itself instead of altering the order using tabindex.
3. Add tabindex attribute values on the JSP pages that contain the custom tag.
4. If the custom control provides its own rendering rather than that of a parent that supports tab
index, call renderTabIndex(StringBuffer) API from the base ControlTag class in the rendering
method.
5. Save the tag library descriptor and JSP files and restart the application server
Even when autocomplete is turned off for the application, it can be turned on for an individual
control. Set autocompleteenabled="true" for the control. Controls that have the same value for
autcompleteid share the same autocomplete list. The maximum autocompletion items to be displayed
is set by the maxautocompletesuggestionsize attribute. The autocompletetarget attribute specifies the
EMC Documentum System Version 6.6 Upgrade and Migration Guide 145
Migrating WDK and Webtop Applications
name of the frame where the completion list should be displayed. By default, the popup appears in
the same frame.
If no autocompleteid is specified, the autocompleteid setting defaults to the form name concatenated
with the control name. In this care, every control on the page will have a different autocompletion list.
Adding autocompletion support to a text or dropdown list control — You can add auto complete
functionality to any control that extends the WDK text or dropdown list controls. Add the four
autocompletion attributes to your control definition in your custom tag library. For example:
<attribute>
<name>autocompleteenabled</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>autocompleteid</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>maxautocompletesuggestionsize</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>autocompletetarget</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
Adding autocompletion support to a non-text control — You can create custom controls that do
not extend text or dropdown list but can support auto complete (effort: complex). To implement
autocompletion in these controls, implement IAutoCompleteEnabledControl in the control class.
The method getInputValue() should get the value that the user has entered and add it to the
autocompletion list. For example, the Text class implements the method in the following way:
public String getInputValue()
{
return getValue();
}
The tag class must bind the autocomplete object during rendering. The following example from the
TextTag class calls a rendering method from renderEnd:
protected void renderEnd(JspWriter out)
throws IOException
{
//...
if (text.isAutoCompleteEnabled())
{
// generate the JavaScript to support AutoComplete
// generate the auto complete list
renderAutoCompleteTextBinding(buf, Text.EVENT_ONVALUECHANGE, null);
}
146 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
Your control class must manage autocompletion data, inclusing retrieving or storing data, managing
list, and flushing old data when needed. You can use AutoCompleteService, which provides the
following APIs:
• public synchronized static AutoCompleteService getInstance ()
• public List getAutoCompleteEntries(String key)
• public void addAutoCompleteEntry(String key, String value)
• public void clearAutoCompleteEntries()
• public int getAutoCompleteMaxSuggestionSize ()
• public Option getAutoCompleteOption ()
• public static void setAutoCompleteOption (Option option)
Add the autocompletion attributes to the tag library descriptor entries for your custom tag.
The data source that will be filtered is specified in the column attribute of the datacolumnbeginswith
control. The column must match a column that is specified within a <column> element of the
component definition. For example, to enable filtering on the object name, the value of the column
attribute should be "object_name".
In the following example, the datacolumnbeginswith control is bound to a datadropdownlist:
<dmf:datagrid ...>
<dmf:datadropdownlist ..>
<dmf:datacolumnbeginswith ../>
</dmf:datadropdownlist ..>
</dmf:datagrid>
EMC Documentum System Version 6.6 Upgrade and Migration Guide 147
Migrating WDK and Webtop Applications
Since: version 6
When a user drags a document into a directory with an item of the same name, a popup menu
displays to allow the user to choose between creating a new rendition of the repository file, or
replacing the content of the existing file with the dropped file. This feature does not require migration.
Preferences changes
Since: version 6
Effort: none to simple, single XML
User preferences are now stored in the global registry in addition to local cookies. Preference storage
in the repository enables users to see their preferences on more than one machine. This feature
does not require migration.
The cookie size has been streamlined for scalability. This enhances reliability and makes the user’s
customized settings available from any client machine.
Saving preferences in a separate repository — By default, user preferences are stored in the global
registry. You can specify a different repository for preferences storage in your custom app.xml
file. Copy the <preferencesrepository> from wdk/app.xml to your app.xml and add the name of
148 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
your preferences repository to the child element <repository>. You can add a triple-DES encrypted
password to the <password> element using the utility class TrustedAuthenticatorTool. With the class
com.documentum.web.formext.session.TrustedAuthenticatorTool in your path, execute the following
command. Substitute the actual password (pwd below) for the user dmc_wdk_preferences_owner:
java com.documentum.web.formext.session.TrustedAuthenticatorTool pwd
Paste the resulting encrypted password into the <password> element in app.xml.
Specifying cookies that are not persisted — User preferences that should not be stored (cookie only)
should be added to the <non_repository_preferences> element. Use this for preferences that should
not be stored in a repository and should be stored only in a cookie, such as login preferences. These
cookies are used before the preferences are downloaded from the preferences storage repository.
Within the <non_repository_preferences> element, each <preference> element contains a value that
corresponds to the XML path to the element within a configuration file that defines the cookie
(nonrepository) preference. If an element has an ID, it must be specified, as in the following example
from the login component:
component[id=login].username
EMC Documentum System Version 6.6 Upgrade and Migration Guide 149
Migrating WDK and Webtop Applications
150 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
EMC Documentum System Version 6.6 Upgrade and Migration Guide 151
Migrating WDK and Webtop Applications
When link scanning is enabled, the following formats will be scanned for links and the linked
documents will be imported or checked in:
• Microsoft Word
• Microsoft Excel
• Microsoft Powerpoint
The following versions of these Office documents are supported:
• 97
• 2000
• XP
• 2003
• 2007
While importing or checking in a document containing linked documents, the user can select the
Document Links option in the Import or Checkin dialog box. When this option is selected, the
user enables scanning of Microsoft Word, Powerpoint, and Excel formats for linked objects while
importing and checking in such files. In addition, when linked documents are imported, the parent
and children are internally treated as virtual documents, but the user will not be able to reorder the
linked documents within the compound document.
Alternatively, users can configure the Document Links option to appear selected by default. The user
selects Tools > Preferences in the General tab of the Preferences dialog box, and selects the Document
Links option to check for links to other documents and include linked documents while importing
and checking in files for Microsoft Word, Powerpoint, and Excel formats. As a result, the Document
Links option is selected by default when the Import and Checkin dialog boxes are displayed.
Note: Content linked with the Office hyperlinks feature is not included in an import or check-in.
3. Save and close the file, and restart the application server.
The user must set the preference to enable link scanning, but this preference will not take effect
unless link scanning is enabled for the application.
152 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
4. Save and close the file, and refresh the configurations in memory by navigating to
http:server/webtop/wdk/refresh.jsp.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 153
Migrating WDK and Webtop Applications
Style changes
The following topics describe changes that affect the style of the UI in recent releases. For information
on CSS style changes, refer to Appendix D, Changes to Webtop Cascading Stylesheets.
Streamline deprecated
Since: version 6
Effort: simple to revert, possibly complex to migrate
The streamline interface was designed to provide quick access to the most commonly used
commands. Version 6.5 introduces the right-click context menu, which provides the same ease of use
in a way that is familiar to most users. The streamline interface is now obsolete and is disabled by
default. However, it still ships with our product for backward compatibility. If you would like to
enable the streamline interface, use one of these methods:
• To re-enable streamline view for all users and all HTTP sessions, add the following setting
in /custom/app.xml:
<streamlineviewvisible>true</streamlineviewvisible>
• To re-enable streamline view for one HTTP session, launch the main component with the
parameter entryPage set to streamline.
For example, Webtop can be launched using a URL similar to
http://localhost:8080/webtop/component/main?entryPage=streamline
Once the streamline view is enabled, it cannot be disabled again within the same HTTP session.
154 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
contrast theme, you will need to adjust your JSP pages to match the changes introduced in the JSP
page design. Refer to the WDK stylesheet changes in the appendix of this document.
Feature changes
The following are changes to the implementation of controls or specific components in WDK/Webtop
applications. Most of these features are enabled by default. These topics tell you how to disable the
new behavior if you prefer not to use it.
Deprecated components
The following component configuration files are deprecated. Customization to the old components
should be updated to point to new component xml files in order to pick up bug fixes and new features.
To disable 5.3 customizations that you may have added to a WDK 6 application, copy this element to
your custom app.xml and remove the <version> element for 5.3:
<supported_versions>
<version>6.0</version>
<version>5.3</version>
</supported_versions>
EMC Documentum System Version 6.6 Upgrade and Migration Guide 155
Migrating WDK and Webtop Applications
The following example lists four attributes, three of which have conditional value assistance lists that
were set up in Documentum Composer. The drop-down list for Make determines the list available for
Model. The drop-down lists Fuel and Year both depend on Model.
This UI was generated from the following set of controls in the JSP page:
<tr>
<td>Make:</td>
<td><dmfxs:searchattribute name=’make’ attribute="make"/></td>
</tr>
<tr>
<td>Model:</td>
<td><dmfxs:searchattribute name=’model’ attribute="model"/></td>
</tr>
<tr>
<td>Year:</td>
<td><dmfxs:searchattribute name=’year’ attribute="year"/><td>
</tr>
<tr>
<td>Fuel:</td>
<td><dmfxs:searchattribute name=’fuel’ attribute="fuel"/></td>
</tr>
156 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating WDK and Webtop Applications
Assigning relationships
Since: version 6
Effort: none
A user can create a relationship between any two documents in the repository. A user can also
delete a relationship between two documents. This feature requires a version 6.5 Content Server
and repository.
This feature does not require migration.
Lifecycle enhancements
Since: version 6
Effort: none
Lifecycle is now displayed on the Properties Screen (part of the default attribute set). Lifecycle is
exposed as a column in object lists. Users are able to apply a lifecycle on documents at creation time
(and Import, Create, Checkin), or later, via the Properties screen. The process of applying a lifecycle to
a document has been enhanced to include the ability to specify the initial lifecycle state and the alias
set. The current success/error messages for the lifecycle-related actions displayed on the Message Bar
that involve a lifecycle state change (Apply, Detach, Promote, Demote, Suspend and Resume) will be
enriched to contain pertinent information about the object lifecycle state (previous and current).
This feature does not require migration.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 157
Migrating WDK and Webtop Applications
158 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Chapter 8
DFC, BOF and WDK Application
Migration to DFS
Documentum Foundation Classes (DFC), Business Object Framework (BOF), and WDK-based
application customizations are a part of many enterprise applications. Documentum Foundation
Services (DFS) is the new EMC Documentum service-oriented architecture that facilitates application
development and produces high quality, maintainable systems. Should existing applications migrate
to DFS? There is no single answer that applies to all custom applications. Table 21, page 159 will help
you decide whether to migrate your applications to the new service-oriented architecture. Details
for these decisions are provided after the table.
Existing DFC and BOF custom application — DFS does not involve rendering or application-specific
logic. DFS is a DFC client and supports all BOF customizations. DFS requires a consumer of web
services to render the UI. If your custom application uses DFC, with or without custom BOF services,
it may be rewritten to use DFS if the features you use are available in DFS. You will need to build DFS
services to expose your BOF code. BOF TBOs and aspects are natively supported by DFS.
Existing DFC and BOF custom applications can be migrated to DFS if you have a web services client
to render the custom application such as Struts, JSF, ASP.NET, or Flex.
Note: BOF modules cannot consume DFS services directly.
Existing WDK-based custom application — If DFS provides feature parity and your WDK-based
application does not have a heavily customized UI, it can be replaced by DFS and a web services
client to render the custom application such as Struts, JSF, ASP.NET, or Flex. If you migrate the
application to DFS and a web services client, you will not be able to apply service packs or future
releases of WDK, Webtop, or the Webtop-based application.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 159
DFC, BOF and WDK Application Migration to DFS
Heavily customized WDK-based applications would generally require much work to replace features
using DFS and a web services client. For new customizations of a WDK-based application, move
business logic to BOF modules or aspects so that they can easily be reused when you migrate to
web services at a later time.
Developing new custom logic in your applications — Whether your existing application is
DFC-based or WDK-based, you should develop custom business logic by building BOF services and
aspects. When you deploy your service on the global registry, your logic is available to all applications
using the global registry, and your custom logic will be easily migrated to a web service in the future.
Moving an existing application to a web services UI — If you have identified a web services UI
for your custom application, you can migrate the application to DFS. Note the guidelines above
for DFC, BOF and WDK custom applications.
160 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Appendix A
Migrating DMCL APIs to DFC
This chapter provides information that can help you migrate a DMCL-based application to a DFC
application. Please also consult the Documentum Foundation Classes Release Notes for any known
limitations or exceptions to the material in this appendix.
Overview
There are essentially three languages used to access the platform: Java, DocBasic, and C++.
If you are using Java for your customizations, they will continue to work in version 6.5 or later. There
have been no changes to the methods or interfaces of existing classes.
In previous releases, DocBasic applications accessed the DMCL via dmcl40.dll (on Windows). In
version 6.5 or later, DocBasic applications will automatically access the new dmcl.dll, which passes
instructions back and forth to DFC via an emulator.
C++ accesses DMCL through dynamic links. Applications can be configured to work with dmcl40.dll,
which ships with version 6.5 and later for backward compatibility. The applications will continue
to work, but they will be working with, in essence, the 6.0 version of DMCL (with some bug fixes).
C++ applications using the dmcl40.dll will not have access to methods or interfaces introduced in
version 6.5.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 161
Migrating DMCL APIs to DFC
IDfSessionManager abortTransaction
Abort, for work flow IDfWorkflow abort
Acquire IDfWorkItem acquire
Addigsignature IDfSysObject addDigitalSignature
Addesignature IDfSysObject addESignature
Addactivity IDfProcess addActivity
Addlink IDfProcess addLink
Addnote IDfSysObject addNote
IDfPackage appendNote
Addpackage IDfWorkflow addPackage
IDfWorkitem addPackageEx
Addpackageinfo IDfActivity addPackageInfo,
addPackageInfoEx
Addport IDfActivity addPort
Addrendition IDfSysObject addRendition, addRenditionEx,
addRenditionEx2,
addRenditionEx3,
Addroutecase IDfActivity addRouteCase, addCondition-
RouteCase
Anyevents IDfSession hasEvents
Append IDfTypedObject appendBoolean, appendInt,
appendDouble, appendId,
appendString, appendTime,
appendValue
Appendcontent IDfSysObject appendContent, appendCon-
tentEx
Appendfile IDfSysObject appendFile
Appendpart IDfSysObject appendPart
162 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating DMCL APIs to DFC
execute, in IDfQuery
Archive IDfSession archive
Assemble IDfSysObject assemble
Assume IDfSession assume
Attach IDfSysObject attachPolicy, detachPolicy
Audit IDfAuditTrailManager registerEventForType,
registerEventForObject,
registerEvents, register
EventsFromQuery,
registerEventsInFolder
Authenticate IDfClient authenticate
IDfSession
IDfSessionManager
Begintran IDfSession beginTrans
IDfSessionManager beginTransaction
Bindfile IDfSysObject bindFile
Branch IDfSysObject branch
Cachequery IDfQuery execute
Changepassword IDfSession changePassword
Checkin IDfSysObject checkin
Checkinapp IDfSysObject checkinEx
Checkout IDfSysObject checkout, checkoutEx
Close IDfCollection close
Commit IDfSession commitTrans
IDfSessionManager commitTransaction
Complete IDfWorkitem complete, completeEx,
completeEx2
Connect IDfSessionManager newSession
IDfClient
Count IDfTypedObject getAttrCount
Create IDfSession newObject, newObjectWithType
Createaudit IDfAuditTrailManager createAudit
EMC Documentum System Version 6.6 Upgrade and Migration Guide 163
Migrating DMCL APIs to DFC
IDfMirror dereferenceMirror
Describe IDfSession describe
Destroy IDfPersistentObject destroy
Disassemble IDfSysObject disassemble
Disconnect IDfSession disconnect (in IDfSession)
164 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating DMCL APIs to DFC
getRepeatingBoolean, getRe-
peatingInt, getRepeatingDouble,
getRepeatingId, getRepeat-
ingString, getRepeatingTime,
getRepeatingValue
Getconnection IDfSessionManager newSession
Getcontent IDfSysObject getContent
Getdocbasemap IDfDocbrokerClient getDocbaseMap
getDocbaseMapFromSpecific-
Docbroker
Getdocbrokermap IDfDocbrokerClient getDocbrokerMap
Getevents IDfSession getEvents
Getfile IDfSysObject getFile, getFileEx, getFileEx2
Getlastcoll IDfSession getLastCollection
Getlogin IDfSession GetLoginTicket, getLoginTicke-
tEx, getLoginTicketForUser
Getmessage IDfSession getMessage
getServerMapFromSpecific-
Docbroker
Grant IDfSysObject grant,
EMC Documentum System Version 6.6 Upgrade and Migration Guide 165
Migrating DMCL APIs to DFC
166 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating DMCL APIs to DFC
IDfWorkflow
IDfWorkitem
Readquery IDfQuery execute
Refresh IDfReplica refreshReplica
IDfMirror refreshMirror
Register IDfSysObject registerEvent
Reinit IDfSession reinit
Remove IDfTypedObject remove
Removeactivity IDfProcess removeActivity
Removecontent IDfSysObject removeContent
Removelink IDfProcess removeLink
Removenote IDfSysObject removeNote
Removepackage IDfWorkitem removePackage
Removepackageinfo IDfActivity removePackageInfo
Removepart IDfSysObject removePart
Removeport IDfActivity removePort
Removerendition IDfSysObject removeRendition,
removeRenditionEx,
removeRenditionEx2
Removeroutecase IDfActivity removeRouteCase
Removestate IDfActivity removeState
Repeat IDfWorkitem repeat
Repeating IDfTypedObject isAttrRepeating
Resolvealias IDfSysObject resolveAlias
IDfSession
Restart IDfSession restart
EMC Documentum System Version 6.6 Upgrade and Migration Guide 167
Migrating DMCL APIs to DFC
resume (IDfWorkitem)
Retrieve IDfSession getIdByQualification (in
IDfSession)
IDfTypedObject
getObjectId (in IDfTypedObject)
Revert IDfPersistentObject revert
Revoke IDfSysObject revoke
setRepeatingBoolean, setRe-
peatingInt, setRepeatingDouble,
setRepeatingId, setRepeat-
ingString, setRepeatingTime,
setRepeatingValue
Setbatchhint IDfSession setBatchHint
Setcontent IDfSysObject setContent, setContentEx,
setContentEx2
Setcontentattrs setContentAttrs
Setdoc IDfSysObject setIsVirtualDocument
Setfile IDfSysObject setFile, setFileEx
Setoutput IDfWorkitem setOutput, setOutputByActivi-
ties
Setpath IDfSysObject setPath
Setperformers IDfWorkflow setPerformers
Setpriority IDfWorkitem setPriority
Setsupervisor IDfWorkflow updateSupervisorName
Shutdown IDfSession shutdown
Signoff IDfPersistentObject signoff
168 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Migrating DMCL APIs to DFC
EMC Documentum System Version 6.6 Upgrade and Migration Guide 169
Migrating DMCL APIs to DFC
170 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Appendix B
Object Type and Property Changes for
version 6.6
These tables describe types and properties that are new, changed, deprecated, or obsolete in version
6.6.
dmi_audittrail_asp_attrs A new type that stores audit information about aspect attribute
changes that are attached to objects.
Note: The new audittrail
improvement types are
created after executing the
following Docbasic script,
in the content server:
%DM_HOME%\bin\dm_
ondemand_schema_
changes.ebs
dm_partition_scheme Defines a particular partitioning scheme.
dm_krb_config_util Stores Kerberos configuration information.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 171
Object Type and Property Changes for version 6.6
• java_access
• credential_id
• credential_key
dmr_content Added the following property:
• i_content_other
• dm_message_route_
user_data records application-specific information about a user referenced in an
archived message.
• dm_message_user_
data
172 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Object Type and Property Changes for version 6.6
• minimum_owner_xpermit
dm_method Added the following property:
• is_restartable
EMC Documentum System Version 6.6 Upgrade and Migration Guide 173
Object Type and Property Changes for version 6.6
174 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Object Type and Property Changes for version 6.6
EMC Documentum System Version 6.6 Upgrade and Migration Guide 175
Object Type and Property Changes for version 6.6
176 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Appendix C
Deployment Settings in WDK-based
Application Deployment
These tables list the mandatory and optional configuration elements that can be set before, during,
and after deployment of WDK-based applications. Because WDK-based applications encapsulate
DFC, you can also configure DFC settings as described in dfcfull.properties located in the
WEB-INF/classes directory of the WDK-based application. Functions marked with an asterisk (*)
must be performed for every deployment.
Table 29, page 177 lists the configuration elements that must be set before deploying a WDK-based
application, such as Webtop or TaskSpace. Not all of these elements must be set for every deployment,
but if you wish to support the function in the first column, you must enable it before deployment.
Refer to Web Development Kit and Webtop Deployment Guide for more information on these settings.
Table 30, page 177 lists the optional configuration settings that can be set before deployment.
EMC Documentum System Version 6.6 Upgrade and Migration Guide 177
Deployment Settings in WDK-based Application Deployment
Table 31, page 178 lists the configuration settings that can be changed after deployment. For
non-deployment related configuration, refer to WDK and Webtop Reference Guide. This guide lists all
configurable elements in WDK and configuration files and tag libraries and notes in which release
the change was introduced.
178 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Deployment Settings in WDK-based Application Deployment
EMC Documentum System Version 6.6 Upgrade and Migration Guide 179
Deployment Settings in WDK-based Application Deployment
180 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Appendix D
Changes to Webtop Cascading
Stylesheets
The majority of styles used in Webtop are defined in webforms.css. To see new styles that you can
use in your JSP pages, you can use a differencing utility to compare the stylesheets from your old
application to the 6.6 application.
The following selectors were removed from webforms.css:
.buttonLink
{
font-family: Trebuchet MS, Verdana, GillSans, Arial;
color: #333333;
text-decoration: none;
font-size: 12px;
line-height: 14px;
font-weight: normal;
}
.buttonDisabledLink
{
color: #999999;
font-family: Trebuchet MS, Verdana, GillSans, Arial;
text-decoration: none;
font-size: 12px;
line-height: 14px;
}
.actionButtonLink
{
font-family: Trebuchet MS, Verdana, GillSans, Arial;
color: #333333;
text-decoration: none;
font-size: 12px;
line-height: 14px;
font-weight: normal;
}
.actionButtonDisabledLink
{
color: #999999;
font-family: Trebuchet MS, Verdana, GillSans, Arial;
text-decoration: none;
font-size: 12px;
line-height: 14px;
font-weight: normal;
}
.bannerbox
{
background: white url("../images/banner/top_left.gif") no-repeat top
left;
EMC Documentum System Version 6.6 Upgrade and Migration Guide 181
Changes to Webtop Cascading Stylesheets
182 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Appendix E
dfc.properties
Overview
In version 6, DFC replaced the Server API as the API for Content Server. As part of this change,
the dmcl.ini file became obsolete and its relevant entries were migrated to the dfc.properties file.
In addition, the naming conventions for entries in the dfc.properties file were standardized. This
appendix describes the changes to the dfc.properties file.
Table 32. Name changes for existing dfc.properties since version 6.5 and dfc.new properties
EMC Documentum System Version 6.6 Upgrade and Migration Guide 183
dfc.properties
dfc.cache.append.name dfc.bof.cache.append_name
dfc.bof.cacheconsistency.interval dfc.bof.cache.currency_check_interval
dfc.bof.registry.connect.attempt.interval dfc.globalregistry.connect_attempt_.interval
dfc.bof.registry.preload.enabled dfc.bof.cache.enable_preload
dfc.bof.registry.password dfc.globalregistry.password
dfc.bof.registry.repository dfc.globalregistry.repository
dfc.bof.registry.username dfc.globalregistry.username
dfc.cache.ddinfo.globalCacheSize dfc.cache.ddinfo.size
dfc.cache.dir dfc.cache_dir
dfc.cache.object.globalCacheSize dfc.cache.object.size
dfc.cache.query.globalCacheSize dfc.cache.query.size
dfc.core.truncate_long_values dfc.compatibility.truncate_long_values
dfc.config.timeout dfc.config.check_interval
dfc.checkout.dir dfc.data.checkout_dir
dfc.data.dir dfc.data.dir
dfc.docbase.max_deadlock_retries dfc.session.max_deadlock_retries
dfc.docbase.max_error_retries dfc.session.max_error_retries
dfc.exception.include_decoration No change
dfc.exception.include_id No change
dfc.exception.include_stack No change
dfc.export.dir dfc.data.export_dir
dfc.housekeeping.cleanup.interval dfc.resources.cleanup_interval
dfc.max.vdm.children.flush.count dfc.vdm.max_children_flush_count
dfc.recordInlineDescendants dfc.xml.record_inline_descendants
dfc.registry.file No change
dfc.registry.mode No change
dfc.resources.diagnostics.enabled dfc.diagnostics.resources.enable
dfc.search.docbase.brokers dfc.search.docbase.broker_count
dfc.search.ecis.adapter.domain dfc.search.external_sources.adapter.domain
dfc.search.ecis.broker_count dfc.search.external_sources.broker_count
dfc.search.ecis.enable dfc.search.external_sources.enable
dfc.search.ecis.host dfc.search.external_sources.host
dfc.search.ecis.password dfc.search.external_sources.password
184 EMC Documentum System Version 6.6 Upgrade and Migration Guide
dfc.properties
dfc.tracing.stackDepth dfc.tracing.max_stack_depth
dfc.tracing.threadNameExprs dfc.tracing.thread_name_filter
dfc.tracing.timestampDateFormat dfc.tracing.date_format
dfc.tracing.timingStyle dfc.tracing.timing_style
EMC Documentum System Version 6.6 Upgrade and Migration Guide 185
dfc.properties
186 EMC Documentum System Version 6.6 Upgrade and Migration Guide
dfc.properties
EMC Documentum System Version 6.6 Upgrade and Migration Guide 187
dfc.properties
188 EMC Documentum System Version 6.6 Upgrade and Migration Guide
dfc.properties
EMC Documentum System Version 6.6 Upgrade and Migration Guide 189
dfc.properties
190 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Index
A D
ACS database
configuration, 153 changing location, 17
attribute, 25 changing version, 17
auto complete, 145 datacolumnbeginswith, 147
Datagrid
Exported selected rows, 122
B datagrid enhancements, 133
BOCS date literals, 28
configuration, 153 DCM
BOF, 108 compatibility, 101
BOF2 modules DCS support
migrating, 105 configuring, 127
enabling, 127
C deep export, enabling, 150
DFC classes
CHANGE...OBJECT statement, 28
migration, 107
CLEAN_LINKS, 26
dfc.compatibility.truncate_long_values, 26
client compatibility
dfc.machine.id, 26
matrix, 49
dfc.properties, 26 to 27
<client_warning_session_timeout>, 114
dfc.session.allow_trusted_login, 28
column resizing, 136
DFS, migration to, 159
compatibility
differences
DCM, 101
DFC Java classes, 107
IRM Services for DCTM, 100
WDK Java classes, 113
matrix, 42
dm_bof_registry, 33
conditional value assistance, 156
dm_extern_file, 27
configuration
dm_linkedstore, 26
WDK, 177
dm_startedworkitem, 26
configuration service extensions, 116
dmcl.ini-keys, 27
configuring
dmi_linkrecord, 26
DCS support, 127
DocApps
consistency checker utility, 103
migrating, 105
content server
DocList component, 136
upgrade matrix, 43
DQL
Content Server
CHANGE...OBJECT statement, 28
listener queue length, configuring, 29
date literals, 28
content store
migrating content, 105
changing location, 17
POSITION keyword, 28
content transfer applet, 154
drag and drop, 148
EMC Documentum System Version 6.6 Upgrade and Migration Guide 191
Index
DRL K
Dynamic Resource Locator, 123 Kerberos
dump and load, 17 Single Sign-on, 120
dynamic filters, 147 keyboard shortcuts, 138
Dynamic Resource Locator
DRL, 123
L
LDIF file, 27
E lifecycle, 157
email migration lightweight sysobjects
introduction, 112 migrating to, 25
EMCMF support in WDK, 130
displaying, 128 linked store storage areas, 26
enable_workitem_mgmt (server.ini listener_queue_length, 29
key), 29 listener_queue_length (server.ini key), 29
enabling login tickets
DCS support, 127 backwards compatibility, 104
Enabling Kerberos authentication, 121 LWSO
Export selected rows support in WDK, 130
Datagrid, 122 LWSOs
export, deep, 150 migrating to, 25
F M
fixed column headers, 136 matrix
fixed menus, 117 client compatibility, 49
compatibility, 42
G upgrade, 42
global registry max_backup_index, 27
defined, 33 max_file_size, 27
memory
application server usage, 20
H DFC usage, 20
hotkeys, 138 <menu>, 117
key combination map, 141 menus
XML definition, 140 fixed, 117
<hotkeys>, 140 migrating
HotKeysNlsProp, 141 BOF2 and DocApps, 105
migrating content with DQL, 105
migration
I overview, 12
IDfSession.setServerTraceLevel, 29 modal popuup. See pop-up, modal
insertbefore, 116 modules
installation order migrating, 105
new system, 12
IPv4 configuration, 107
IRM Services for DCTM O
compatibility, 100 optical storage devices, 27
IRM support, 127
192 EMC Documentum System Version 6.6 Upgrade and Migration Guide
Index
P shortcuts
performance key combination map, 141
planning, 20 showifinvalid, 148
Server, common problems, 21 showinvalidactions, 148
web application, 22 Single sign-on
planning worksheet Kerberos, 120
application server host, 31 Streamline, 154
Planning worksheet SYNC_REPLICA_RECORDS, 27
client machine, 31 system
Content Server host, 30 sizing, 19
customized components, 32 system updates
index server host, 31 order, 13
pop-up, modal
disabling, 123 to 124 T
invoking, 124 tab order, 144
overview, 123 TBO, 108
refresh parent, 126 themes, 154
window.location.replace, 127 timeout warning, 114
POSITION keyword, 28 Toolbar component, 138
preference persistence, 148 tracing, memory
presets, 115 DFC, 20
Q U
query upgrade
performance enhancement, 22 matrix, 42
overview, 11
R upgrade matrix
relationships, 157 for content server, 43
renditions
viewing application per user, 153 V
resizeable columns, 136 value assistance, conditional, 156
right-click menus, 137
row selection, 134
W
WDK classes
S migration, 113
safe harbor, 9 work flow
SBO, 108 enable_workitem_mgmt (server.ini
server.ini file key), 29
enable_workitem_mgmt key, 29
server_login_ticket_version (server.ini
key), 104
EMC Documentum System Version 6.6 Upgrade and Migration Guide 193