Documentum Administrator 6.6 Release Notes

EMC® Documentum®

Documentum AdministratorVersion 6.6

Release Notes

EMC CorporationCorporate Headquarters:

Hopkinton, MA 01748-91031-508-435-1000www.EMC.com

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

The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kindwith respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitnessfor a particular purpose. Use, copying, and distribution of any EMC software described in this publication requires anapplicable software license.

For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarksused herein are the property of their respective owners.© Copyright 2010 EMC Corporation. All rights reserved.

Revision History:May 2010: Initial Release.

Table of Contents

Chapter 1 Product Description .................................................................................... 7

Chapter 2 New Features and Changes in Documentum Administrator ........................ 9New features and changes in release 6.6............................................................. 9Java Method Server configuration.................................................................. 9Object owner permission changes .................................................................. 9Support for Atmos stores .............................................................................. 11Graceful shutdown of workflow agent ........................................................... 11Kerberos SSO support................................................................................... 12Job scheduling improvements ....................................................................... 12Administration methods for login tickets ....................................................... 12LDAP SSL mode configuration ...................................................................... 13

Chapter 3 Environment and System Requirements ..................................................... 15Hardware requirements .................................................................................... 15Browser machine requirements ..................................................................... 15Web application server machine requirements................................................ 16

Software requirements ...................................................................................... 16Browser environment ................................................................................... 17Web application server environment.............................................................. 25Java version support ..................................................................................... 30External web server environments ................................................................. 32Additional operating environments ............................................................... 32VMware support ...................................................................................... 32IBM Logical Partitioning support............................................................... 33Sun Microsystems support ........................................................................ 33Citrix support........................................................................................... 34Siteminder support ................................................................................... 34RSA support ............................................................................................ 34Native 64-bit support ................................................................................ 35Prerequisites to run Documentum 6.5 and later products inthe native 64-bit mode........................................................................... 3564-bit support in browser environment .................................................. 3564-bit support in web application server environment............................. 35

IPv6 support ............................................................................................ 35Applet certificates......................................................................................... 36

Cross-product dependencies and interoperability ............................................... 37Embedded products ......................................................................................... 37

Chapter 4 Fixed Problems ........................................................................................... 39Fixed problems for version 6.6........................................................................... 39Classloader used by the BOF2 objects are not loading the expectedxml libraries (141153, 152781) ........................................................................ 39Invisible federation object using DA (164278/DA-892) ..................................... 40No change in a_next_invocation_date attribute while changingStart Date and Time job attribute(DA-1146) .................................................... 40

EMC Documentum Administrator Version 6.6 Release Notes 3

Table of Contents

Configuration of LDAP with SSL fails (DA-2804) ............................................ 40Upgrading from 5.3 SP6 to 6.5 SP2 repository fails (DA-3375) .......................... 40Mismatch in count in Files column of categories (DA-3388) ............................. 40Repository properties sharing the same name but a different typecannot be added in the property mapping attribute of the LDAPconfiguration object (DA-3666) ...................................................................... 40

Chapter 5 Known Problems and Limitations ............................................................... 43Known problems .............................................................................................. 43Migration policy trace files (80728)................................................................. 43Reordering assignment policy rules (80839).................................................... 43Documents locked after a user or group is reassigned (CS-3839) ...................... 44Creating an SSL-enabled LDAP configuration object fails on HPIAPlatform (DA-648/170896) ............................................................................. 44Index Agent MBean log file is not downloaded (DA-737/153922) ..................... 44Deployment fails on Windows Server 2003 SP2 (32-bitversion)/Oracle AS 10g Release 3 (10.1.3.3.0) environment(DA-742/154754) ........................................................................................... 44Changing the owner of an already assigned ACL does not changethe acl_domain of the affected objects (DA-1264/118785) ................................. 45Two references to the same group appear after reassigning(DA-1468/136710) ......................................................................................... 45Changing the ACL or home cabinet for a user requires superuserprivileges (DA-3365) ..................................................................................... 45Object type dm_message_archive lost in docset properties (DA-3607) .............. 45Replacing, deleting or revoking of LDAP database certificates isnot supported (DA-3620)............................................................................... 45Removing a role member after a search generates runtimeexception error (DA-3854) ............................................................................. 46Known problems common to all WDK applications ........................................ 46

Limitations....................................................................................................... 46Menu behavior ............................................................................................. 46Failover ....................................................................................................... 46File store and job names ............................................................................... 46Viewing log files........................................................................................... 47Inherited default ACL must have Read access ................................................ 47Simple search fails with an error message in several minutes afterIndex Server has restarted (DA-3627) ............................................................. 47Failover not supported in clustered environments .......................................... 47Compatibility limitations between CIS server and CI API clients ..................... 47Error on folder names with single quotes (CIS-164) ......................................... 48Selector pages .............................................................................................. 48Server and connection broker logs ................................................................. 48

Chapter 6 Technical Notes ........................................................................................... 49Customization not supported ............................................................................ 49Adding connection brokers ............................................................................... 49Displaying job trace files ................................................................................... 49View Jobs button .............................................................................................. 49Repositories with Trusted Content Services enabled............................................ 50Accessibility options not supported ................................................................... 50User privileges ................................................................................................. 50Reassigning users objects .................................................................................. 50Japanese Documentum Administrator ............................................................... 50

4 EMC Documentum Administrator Version 6.6 Release Notes

Table of Contents

LDIF files ......................................................................................................... 51LDAP configurations ........................................................................................ 51Audit events in new repositories ....................................................................... 51Assignment policies.......................................................................................... 51Documentum resource agents ........................................................................... 51Enabling or disabling the write mode................................................................. 52Blank page error on deploying DA .................................................................... 52

Chapter 7 Documentation ............................................................................................ 55Documentum Administrator documentation set ................................................. 55Obtaining the correct documentation ................................................................. 55

Chapter 8 Software Media, Organization, and Files ..................................................... 57Software media ................................................................................................ 57Organization .................................................................................................... 57Files................................................................................................................. 57

Chapter 9 Deployment ................................................................................................. 59

Chapter 10 Troubleshooting and Getting Help .............................................................. 61


Table of Contents

List of Tables

Table 1. Minimum and extended object owner permissions ................................................. 10Table 2. Web application server machine requirements........................................................ 16Table 3. Third-party product versions not supported in this release...................................... 17Table 4. Browser environment (1 of 3) ................................................................................ 18Table 5. Browser environment (2 of 3) ................................................................................ 21Table 6. Browser environment (3 of 3) ................................................................................ 24Table 7. Web application server environment (1 of 2)........................................................... 26Table 8. Web application server environment (2 of 2)........................................................... 28Table 9. Java version support ............................................................................................. 31Table 10. External web server environments ......................................................................... 32Table 11. VMware support .................................................................................................. 32Table 12. IBM Logical Partitioning support........................................................................... 33Table 13. Sun Microsystems support .................................................................................... 34Table 14. Citrix support....................................................................................................... 34Table 15. Documentum Administrator IPv6 compliance ........................................................ 36Table 16. Applet certificates of Webtop................................................................................. 36Table 17. Applet certificates of Documentum Application Connectors.................................... 36Table 18. Applet certificates of Web Publisher....................................................................... 36Table 19. Applet certificates of TaskSpace ............................................................................. 37Table 20. JMX Service URLs ................................................................................................ 51


Chapter 1Product Description

Documentum Administrator enables you to monitor, administer, configure, and maintainDocumentum servers, repositories, and federations located throughout your company from onesystem running a web browser. Documentum Administrator is a Web-based tool used to performmost of the system administration tasks for a Documentum system. These administration tasksinclude:• Configuring servers, repositories, and federations

• Creating and changing users, groups, roles, permission sets, and LDAP configurations

• Managing content storage areas and full-text indexing

• Creating Content Delivery configurations for Interactive Delivery Services

You can perform all document management functions (create new documents, check in and checkout, start workflows) from Documentum Administrator.


Product Description


Chapter 2New Features and Changes inDocumentum Administrator

EMC Documentum Administrator version 6.6 includes new features and several improvements.Refer to the product documentation for complete information about these features.

New features and changes in release 6.6This section describes the new features, enhancements, and changes in Documentum AdministratorVersion 6.6.

Java Method Server configuration

In release 6.6, Documentum Administrator offers a Java Method Server (JMS) node that allows usersto view and modify JMS configurations. JMS is a customized version of JBoss to execute ContentServer Java methods. One JMS is installed with each Content Server installation. DocumentumAdministrator provides a Java Method Server configuration page for• Viewing and updating Java Method Servers.

• Associating Content Servers with Java Method Servers.

• Viewing the Java Method Server status information in the Content Server memory cache.

• Resetting the Java Method Server information in the Content Server memory cache.

Java Method Servers (JMS) are displayed on the Java Method Server Configuration page. Users withsuperuser or system administrator privileges can access the Java Method Server Configuration page.To access the page, log into a repository and navigate to Administration > Basic Configuration >Java Method Servers.

Object owner permission changes

Documentum Administrator version 6.6 allows administrators to control the minimum and theextended permissions for object owners. The minimum owner permissions are granted regardless


New Features and Changes in Documentum Administrator

of any restrictions that are specified in the ACL of the object and prevent users from accidentallyexcluding themselves from being able to modify objects they own.

The minimum and extended object owner permissions apply to the entire repository and can beconfigured on the Repository Configuration Properties page under the Repository node. Users withsuperuser privileges can access Repository Configuration Properties page. To access the page, loginto a repository and navigate to Administration > Basic Configuration > Repository.

The minimum and extended object owner permissions can be configured as follows:

Table 1. Minimum and extended object owner permissions

Permission Description

Minimum Owner Permission Specifies the minimum permission for an objectowner after all ACL rules have been applied.The permission applies to the entire repository.Valid values are:• Browse

• Read

• Relate

• Version

• Write

• Delete

The default value is Browse.

Minimum Owner Extended Permission Specifies the minimum owner extendedpermissions for an object owner after all ACLrules have been applied. One or more extendedpermissions can be selected. By default, noextended permission is selected. Valid valuesare:• Execute Procedure

Users with superuser privileges can changethe owner of an item and run externalprocedures on certain types.

• Change Location

Allows the object owner to move the objectin the repository.

• Change State

Allows the object owner to change the state ofa lifecycle attached to the object.

• Change Permission



Permission Description

Allows the object owner to modify the basicpermissions associated with the object.

• Change Ownership

Allows the object owner to change the objectowner.

• Extended Delete

Allows the object owner to delete the object.

• Change Folder Links

Allows the object owner to link or unlink theobject to a folder.

Support for Atmos stores

Documentum Administrator version 6.6 supports Atmos stores. An Atmos store is an EMC softwarestorage system that consists of several distributed services running on a network of connectedhardware nodes. Each node is attached to one more disk enclosures. The nodes run a collection ofservices to store, retrieve, categorize, and manage the data in the system or cloud. Content Serveruses the ACS connector to communicate with the Atmos store. The ACS module supports storing andretrieving of content through an HTTP interface.

Users can create, view, and modify Atmos stores from the Storage page under the StorageManagement node. To access the Storage page, log into a repository and navigate to Administration> Storage Management > Storage.

Graceful shutdown of workflow agent

Documentum Administrator version 6.6 supports graceful shutdown of a workflow agent. Theworkflow agent controls the execution of automatic activities in a workflow. The new systemshutdown timeout property on the Server Configuration page sets the time that the workflow agentattempts to shut down work items gracefully after receiving a shutdown command.

User can modify system shutdown timeout on the Server Configuration Properties page. To accessthe page, log into a repository and navigate to Administration > Basic Configuration > ContentServers, select a server configuration object in the Name column, then selectView > Properties > Info.

The system shutdown timeout property on the server configuration object sets the time that theworkflow agent attempts to shut down work items gracefully after receiving a shutdown command.This feature is only applicable for repositories that use multiple Content Servers.

If the shutdown timeout period is exceeded (or is set to zero), the workflow agent shuts downimmediately. When the workflow agent does not shut down gracefully, automated tasks in certain



states can be corrupted. If tasks are corrupted, restarting the Content Server does not result inresumption of the managed workflows. The server log file indicates when a graceful shutdown didnot occur. Use the RECOVER_AUTO_TASKS administration method to recover the automated tasks.

Kerberos SSO support

Documentum Administrator version 6.6 supports Kerberos SSO user authentication, which providesa secure Single-Sign-On (SSO) solution using Windows Integrated Authentication. Kerberos issupported on Content Server using the Microsoft Active Server Domain Services for Kerberos KeyDistribution Center (KDC) services.

Note: Kerberos SSO authentication is not supported on ACS and BOCS servers.

The Kerberos authentication plug-in that enables Kerberos support for KDC services is automaticallyinstalled with Content Server. There are additional steps to enable Kerberos SSO on the ContentServer that have to be completed subsequent to Content Server installation. These additional stepsinclude:• Determining the Kerberos Service Principal Name (SPN).

• Registering the SPN on the Active Directory and generating a Keytab file using the WindowsServer Ktpass utility.

• Creating Kerberos users in the repository.

• Configuring LDAP synchronization for Kerberos users.

For detailed information about enabling Kerberos SSO authentication, refer to Appendix D "KerberosSupport” in the Documentum Administrator User Guide.

Job scheduling improvements

Documentum Administrator version 6.6 offers improvements for job scheduling. For existing jobs,users can specify the next invocation date. When the job is run, the next invocation date is computedbased on the current date and the scheduled frequency.

Administration methods for login tickets

Documentum Administrator version 6.6 provides two new administration methods for login tickets:• The EXPORT_TICKET_KEY administration method encrypts and exports a login ticket fromthe repository to a client machine.

• The IMPORT_TICKET_KEY administration method decrypts a login ticket from a client machineand imports the ticket into the repository.



LDAP SSL mode configuration

Documentum Administrator version 6.6 eliminates the need to copy platform dependent librariesinto the application server path and the platform dependent JSS jar file into application server classpath. If the SSL mode has been enabled on the LDAP Configuration object, the LDAP CertificateDatabase automation functionality imports all SSL certificates into the certificate database.




Chapter 3Environment and SystemRequirements

This chapter lists the hardware (machine) requirements and software versions supported with thisrelease. Machine resources, non-Documentum software components (Operating System, JavaRuntime Environment, and so forth), and other EMC Documentum products determine the uniqueenvironment for each EMC Documentum product. Hardware requirements, page 15, addresses basicmachine resource requirements. Software requirements, page 16, addresses specific software versionsthat are required for the installation platform.

Documentum Administrator (DA) operates on a browser client and a web application server. Whenthe supported environments for the browser client and web application server are the same, they canbe on the same machine. Otherwise, they need to be on different machines.

Hardware requirementsThis section lists nominal machine resources required for product installation and use. Yourindividual machine requirements vary depending on factors such as the number of productsinstalled, size of your deployment, number of users, and network latency. The Documentum SystemSizing Tool dynamically generates estimates of your hardware resource requirements based on youruser and hardware profile.

You can download the Documentum System Sizing Tool from the Powerlink website(http://powerlink.emc.com) by navigating to: Home > Support > Technical Documentation andAdvisories > Software ~ D ~ Documentation > Documentum System > Systems Sizing.

Browser machine requirements

For WDK-based client applications, you need a client machine capable of running the supportedsoftware configurations listed in Browser environment, page 17, plus whatever disk space, RAM, orCPU requirements that may be specified by third-party products such as Microsoft Office.

WDK-based client applications may install applets and a JRE on the client machine. This requiresapproximately 100 MB of free hard disk space. Additionally, you need sufficient free disk spaceto handle checked-out and cached documents.


http://powerlink.emc.com

Environment and System Requirements

Web application server machine requirements

The Table 2, page 16 provides nominal resource requirements for Documentum Administrator on aweb application server machine.

Table 2. Web application server machine requirements

Hard disk space [1] RAM [2] CPU

Minimum:

600 MB for one application

1 GB for two applications

Recommended:

800 MB for one application

1.2 GB for two applications

2 GB 800 Mhz (minimum), 1 GHz orgreater (recommended)

Note: The following specific notes apply to the web application server machine requirements table:

[1] You must also have sufficient free disk space to handle temporary content transfer files, whichcan vary substantially from one enterprise to another.[2] The amount of RAM that is available after taking into consideration all other RAM utilizationrequirements.

Software requirementsThis section provides information on supported software environments.

The tables in this section reflect the latest versions of third-party products, upon which the EMCDocumentum product depends, that are supported at the time of this release. EMC Documentumrecommends that you upgrade third-party products to the version listed for this release. If youcannot upgrade your third-party products to the version listed for this release, EMC Documentumcontinues to support all third-party product versions supported for EMC Documentum productversions 6.x and 5.3x, with the following caveats:• the third-party product is not of the same or earlier version than those versions listed in Table3, page 17

• the third-party product version is still supported by the third-party vendor

• the third-party product version is forward compatible with the version supported in this release.

For information on currently supported environments and future updates, refer to the ProductInformation System on the Powerlink website: http://powerlink.emc.com.




Table 3. Third-party product versions not supported in this release

Product Category Third-party product Version

Windows 2000 SP2 Update Rollup 1

Mac OS X 10.2.8, 10.3.9

Solaris 8

AIX 5.2

HP-UX HP-UX 11

Operating System

Red Hat Enterprise Linux 3.x

Oracle 9i 9.2.0.8, 10.1.0.5

SQL Server 2000 SP4Database

DB2 UDB 8.1 FixPak 14, 8.2 FixPak 7

BEA WebLogic Server 8.1 SP6

Tomcat 5.0.28

IBM WebSphere AS 5.1.1.13, 6.0.2.17Application Server

Oracle AS 10g 9.0.4.3, 10.1.2

Mozilla 1.7.13

Netscape 7.2Browser

Safari 1.3.2

Sun JRE 1.4.2_13

Microsoft JVM 5.0.0.3810JRE (Client)

Apple Java 1.3.1 Release 2

Java (Server) Java 1.4.x

BEA WebLogic Portal 8.1 SP6Portal Server

IBM WebSphere Portal 5.1.0.4

Browser environment

The user interface for Documentum Administrator runs in a browser environment. The browserenvironment consists of a specific combination of operating system, browser, and JRE. The browserenvironment tables for Documentum Administrator (Table 4, page 18, Table 5, page 21, and Table 6,page 24) lists the supported browser environments.



Table 4. Browser environment (1 of 3)

Operating system/Processor (1 of 3)

Browser JRE

WinXP SP3(32-bit)/IA-32,x64

WinVistaSP2(32-bit)/IA-32,x64

Win7 (32-bit)/IA-32, x64

Win7 (64-bit)/x64

WinServer2003R2withSP2(32-bit)/IA-32,x64

WinServer2003SP2(32-bit)/IA-32, x64


WinServer2008SP2(64-bit)/x64

WinServer2008R2 (64-bit)/x64

IE6 for Win XPSP3 [1]

Sun JRE 5.0Update 22, 6.0Update 18

X

IE6 SP2 for WinServer 2003 SP1[2]


X X

IE7 for Win XP,Server 2003 [3]


X X X

IE7 for Win VistaSP1 [4]


X X X

IE7 for Win Server2008 [4]

Sun JRE 5.0Update 22 X

IE7 for Win Server2008 [4]

Sun JRE 6.0Update 18 X X




Browser JRE



Win7 (32-bit)/IA-32, x64

Win7 (64-bit)/x64






IE8 for Win XP,Vista, Server 2003,Server 2008 [5]


X X X X X X


Sun JRE 5.0Update 22 X


Sun JRE 6.0Update 18 X X

IE8 for Win 7 [6]Sun JRE 5.0Update 22, 6.0Update 18

X X

Firefox 2.0.0.20Sun JRE 5.0Update 22, 6.0Update 18

X X X X X X

Firefox 2.0.0.20 Sun JRE 5.0Update 22 X

Firefox 2.0.0.20 Sun JRE 6.0Update 18 X X




Browser JRE



Win7 (32-bit)/IA-32, x64

Win7 (64-bit)/x64






Firefox 3.0.16Sun JRE 5.0Update 22, 6.0Update 18

X X X X X X

Firefox 3.0.16 Sun JRE 5.0Update 22 X

Firefox 3.0.16 Sun JRE 6.0Update 18 X X

Firefox 3.5.6Sun JRE 5.0Update 22, 6.0Update 18

X X X X X X

Firefox 3.5.6 Sun JRE 5.0Update 22 X

Firefox 3.5.6 Sun JRE 6.0Update 18 X X

Note: The X symbol denotes the supported combination of browser, JRE, and operating system.





Browser Java plug-in

Mac OSX 10.4.11/PowerPC,IA-32, x64

Mac OSX 10.5.8Updatev1.1/PowerPC,IA-32, x64

Mac OSX 10.5.8Updatev1.1/x64



Mac OS X10.6.2/x64

Firefox 2.0.0.20Java for Mac OSX 10.4 Release 9(1.4.2_21), (1.5.0_19)

X

Firefox 2.0.0.20Java for Mac OSX 10.5 Update 5(1.4.2_22), (1.5.0_22)

X X X

Firefox 2.0.0.20Java for Mac OSX 10.5 Update 6(1.6.0_17)

X X

Firefox 2.0.0.20Java for Mac OSX 10.6 Update 1(1.6.0_17)

X

Firefox 3.0.16Java for Mac OSX 10.4 Release 9(1.4.2_21), (1.5.0_19)

X

Firefox 3.0.16

Java for Mac OSX 10.5 Update 5(1.4.2_22), Update 6(1.5.0_22)

X X X










Mac OS X10.6.2/x64

Firefox 3.0.16Java for Mac OSX 10.5 Update 6(1.6.0_17)

X X


X

Firefox 3.5.6Java for Mac OSX 10.4 Release 9(1.4.2_21), (1.5.0_19)

X

Firefox 3.5.6Java for Mac OSX 10.5 Update 5(1.4.2_22), (1.5.0_22)

X X X


X X


X

Safari 2.0.4Java for Mac OSX 10.4 Release 9(1.4.2_21), (1.5.0_19)

X










Mac OS X10.6.2/x64

Safari 3.2.3

Java for Mac OSX 10.5 Update 5(1.4.2_22), Update 6(1.5.0_22)

X

Safari 3.2.3Java for Mac OSX 10.5 Update 6(1.6.0_17)

X

Safari 4.0.4Java for Mac OSX 10.4 Release 9(1.4.2_21), (1.5.0_19)

X


X X


X X


X

Note: The X symbol denotes the supported combination of browser, Java plug-in, and operating system.





Browser JRE

Solaris10/Ultra-SPARC

RHEL4.8/IA-32,x64

RHEL5.4/IA-32,x64

SUSELinux En-terpriseDesktop10 SP3/IA-32, x64

SUSELinuxEnter-priseDesktop11/IA-32,x64

SUSELinux En-terpriseServer 10SP3/IA-32, x64

SUSELinuxEnter-priseServer11/IA-32,x64

Firefox 2.0.0.20 Sun JRE 5.0 Update22, 6.0 Update 18 X X X X X X X

Firefox 3.0.16 Sun JRE 5.0 Update22, 6.0 Update 18 X X X X X X X

Firefox 3.5.6 Sun JRE 5.0 Update22, 6.0 Update 18 X X X X X X X

Note: The X symbol denotes the supported combination of browser, JRE, and operating system.



Note: The following specific notes indicated by [ ] apply to the browser environment table:

[1] Build number of this browser is 6.00.2900.3311.[2] Build number of this browser is 6.00.3790.3959.[3] Build number of this browser is 7.00.5730.1300.[4] Build number of this browser is 7.00.6001.1800.[5] Build number of this browser is 8.00.6001.18702.[6] Build number of this browser is 8.00.7000.00000.

Note: The following general notes apply to the browser environment table:• The following Windows Server 2003 editions are supported: Standard, Enterprise, Data Center.

• IA-32 = Intel Architecture 32-bit

• x64 = 64-bit Architecture which includes AMD64 and Intel 64

• For Windows XP SP3, you must either disable its built-in popup-blocker, or you must add the webapplication server as a trusted site.

• Cookies must be enabled in the browser.

• In order for UCF content transfer related operations such as import, export, view, checkout,checkin, preferences to work under the Windows Vista operating system, you must choose oneof the following: turn off User Account Control (UAC) for each user, or in the browser add thesite to the list of Trusted Sites in IE7 and in the application set the UCF client configurationregistry.mode value to file instead of windows.

• The following Red Hat Enterprise Linux editions are supported: AS, ES, WS, and Desktop.

• D6.x Documentum Administrator, Webtop, Digital Asset Manager, My Documentum forMicrosoft Outlook (formerly Documentum Client for Outlook) and custom Web DevelopmentKit/Documentum Foundation Classes applications are backward compatible with 5.3.x ContentServers.

• Tier 1 language versions of the operating system and browser are supported. Tier 1 languagesare French, Italian, German, Spanish, Swedish, Brazilian-Portuguese, Dutch, Simplified Chinese,Japanese, Korean, Russian, and Arabic.

Web application server environment

Documentum Administrator runs in a web application server environment. The web applicationserver environment consists of a specific combination of web application server, operating system,and processor. The web application server environment tables for Documentum Administrator (Table7, page 26 and Table 8, page 28) lists the supported web application server environments.



Table 7. Web application server environment (1 of 2)


Webapplicationserver

WindowsServer 2003R2 with SP2(32-bit)/IA-32, x64

WindowsServer 2003R2 with SP2(32-bit)/x64[3]

WindowsServer 2003SP2 (32-bit)/IA-32, x64

WindowsServer 2003SP2 x64Edition/x64[3]


WindowsServer 2008SP2 (64-bit)/x64

WindowsServer 2008R2 x64Edition/x64[3]

ApacheTomcat 5.5.28 X X X X X X X

ApacheTomcat 6.0.20 X X X X X X X

BEAWebLogicServer 9.2MP3 [2]

X X X X

OracleWebLogicServer 11gR1 (10.3.2) [2][4]

X [1] X [1] X [1] X [1] X [1] X [1] X [1]

IBM WASV6.1 Fix Pack27 (6.1.0.27)

X [1] X [1] X [1] X [1]


X [1] X [1] X [1] X [1] X [1] X [1] X [1]





WindowsServer 2003R2 with SP2(32-bit)/IA-32, x64

WindowsServer 2003R2 with SP2(32-bit)/x64[3]


WindowsServer 2003SP2 x64Edition/x64[3]


WindowsServer 2008SP2 (64-bit)/x64

WindowsServer 2008R2 x64Edition/x64[3]

Oracle AS10g R3(10.1.3.3.0)

X X X X

Red HatJBoss EAP4.3.0

X X X X

Note: The X symbol denotes the supported combination of operating system and web application server.



Table 8. Web application server environment (2 of 2)



So-laris10/Ul-tra-SPARC[3]

AIX 5LV5.3TL10,AIXV6.1TL3/Power[3]

HP-UX 11iv2 Update2 (B.11.23),v3 Update5 (B.11.23)/PA-RISC2.0 [3]

HP-UX 11iv2 Update2 (B.11.23), v3Update 5(B.11.23)/Itanium 2[3]

RHEL4.8,5.4/IA-32

RHEL4.8,5.4/x64[3]

SUSELinuxEnterpriseServer 10SP3/IA-32

SUSELinux En-terpriseServer 10SP3/x64[3]

SUSELinux En-terpriseServer 11SP3/IA-32

SUSELinux En-terpriseServer11/x64 [3]

ApacheTomcat 5.5.28 X X X X X X X X X X

ApacheTomcat 6.0.20 X X X X X X X X X X

BEAWebLogicServer 9.2MP3 [2]

X [1] X X X X X X X X X

OracleWebLogicServer 11g R1(10.3.2) [2] [4]

X [1] X X X X X X X X X


X [1] X [1] X [1] X [1] X [1] X [1] X [1] X [1] X [1]


X [1] X [1] X [1] X [1] X [1] X [1] X [1] X [1] X [1]





So-laris10/Ul-tra-SPARC[3]

AIX 5LV5.3TL10,AIXV6.1TL3/Power[3]

HP-UX 11iv2 Update2 (B.11.23),v3 Update5 (B.11.23)/PA-RISC2.0 [3]

HP-UX 11iv2 Update2 (B.11.23), v3Update 5(B.11.23)/Itanium 2[3]

RHEL4.8,5.4/IA-32

RHEL4.8,5.4/x64[3]

SUSELinuxEnterpriseServer 10SP3/IA-32

SUSELinux En-terpriseServer 10SP3/x64[3]

SUSELinux En-terpriseServer 11SP3/IA-32

SUSELinux En-terpriseServer11/x64 [3]

Oracle AS 10gR3 (10.1.3.3.0) X X X X X [1] X [1] X [1] X [1] X [1] X [1]

Red Hat JBossEAP 4.3.0 X X X X X X X

Sun JavaSystemApplicationServer 8.2

X

Sun GlassFishEnterpriseServer v2.1[5]

X

Note: The X symbol denotes the supported combination of operating system and web application server.



Note: The following specific notes indicated by [ ] apply to the web application server environmenttable:

[1] Clustering (failover) support. See general notes for exceptions below.[2] WebLogic web application server clustering support requires external load balancer or WebServer acting as a load balancer.[3] Support 64-bit version of operating system in native mode.[4] Oracle WebLogic 10.3 is also supported since it is a 10g release as per Oracle.[5] Sun Java System Application Server 9.1.1 is renamed to Sun GlassFish Enterprise Server v2.1.

Note: The following general notes apply to the web application server environment table:• The following Windows Server 2003 editions are supported: Standard, Enterprise, Data Center.



• Support all the Java 5.0.x and 6.0.x version supported by each web application server. No supportfor JDK 1.4.x.

• Support 32-bit version and 64-bit version of web application server.

• Web servers internal to the supported web application servers are supported.

• The Web server associated with a web application server, whether internal or external, must alsosupport chunked requests. This means that Web servers forward HTTP requests using chunkedtransfer encoding (as described in the HTTP/1.1 protocol) to the back-end web application server.If chunked requests are not supported then the client should use "UCF Alternative Chunking”mode. For details on configuring and using "UCF Alternative Chunking” mode, refer to theWeb Development Kit Development Guide.

• Only the following forward proxy configurations are supported:— Auto configuration script

— Explicitly specifying the proxy server (for example, the host and port)

— Auto detect settings, configured using ProxyCfg.exe (proxy configuration tool)

• Clustering (failover) is not supported for Documentum Administrator.

• English, Simplified Chinese, Japanese, Korean, Russian (English with regional setting set toRussian), and Arabic (English with regional setting set to Russian) versions of the operatingsystem are supported.

Java version support

The Java version support table consists of a specific combination of Java version, and web applicationserver.



Table 9. Java version support

Web application server

Java

ApacheTomcat5.5.28

ApacheTomcat6.0.20

BEA We-bLogicServer9.2 MP3

OracleWebLogicServer 11gR1 (10.3.1)

IBM WASV6.1 FixPack 27(6.1.0.27)

IBM WASV7.0 FixPack 5(7.0.0.5)

OracleAS 10gR3 (10.1.3.3.0)

Red HatJBossEAP4.3.0

Sun JavaSystemAppli-cationServer 8.2

SunGlassFishEnterpriseServerv2.1

5.0.x X X X X X X X X

6.0.x X X X X X X

Note: The X symbol denotes the supported combination of Java and web application server.



External web server environments

This section describes supported web server configurations for web application servers used withWDK-based products. You may wish to utilize the security benefits associated with a web server. Youcan also setup a forward or reverse proxy to the web application server using one of the supportedconfigurations listed in the following table.

Table 10. External web server environments

External web server Clustering supportApache 2.0.63 No

Apache 2.2.14 No

IBM HTTP Server 6.1.0 Fix Pack 27 (6.1.0.27) No

IBM HTTP Server 7.0.0.0 No

Microsoft Internet Information Server (IIS) 6.0 No



Sun Java System Web Server 6.1 SP10 Failover, LoadBalancing

Sun Java System Web Server 7.0 Update 4 Failover, LoadBalancing

Note: The following general notes applies to the external web server environment table:• We support the above listed external Web servers only when the Web server is available on thesame operating system version as the associated application server.

• We support the above listed Web servers used with single sign-on products listed in the Operatingenvironment table if it is supported by the single sign-on products.

Additional operating environments

This section provides information on supported operating environments.

VMware support

The following table lists the VMware product versions supported on specific operating system(s).

Table 11. VMware support

Product Operating system Processor

VMware ServerWindows & Linux (SeeVMware website for the specificsupported version)

IA-32, x64



Product Operating system Processor

VMware WorkstationWindows & Linux (SeeVMware website for the specificsupported version)

IA-32, x64

VMware ESX Server N/A IA-32, x64

Note: The following general notes apply to the VMware support table:



• Documentum fully supports all of our products running on a guest operation system supportedby the version of VMware products listed as long as that same version of operating systemis supported by the appropriate EMC Documentum product. VMware supports only x86microprocessor architecture.

• Supports VMware vSphere vCenter Server Version 4.0.0 Build 162856, ESX 4.0.0 Build 164009and Atmos versions.

IBM Logical Partitioning support

The following table lists the IBM Logical Partitioning (LPAR) product versions supported on specificoperating system(s).

Table 12. IBM Logical Partitioning support

Product versions Operating system ProcessorIBM Logical Partitioning(LPAR) [1] [2]

AIX 5L V5.3 TL10AIX V6.1 TL3 Power

Note: The following specific note indicated by [ ] applies to the IBM Logical Partitioning support table:

[1] Only one LPAR is supported and multiple LPARs are not supported for Index Server.[2] LPAR specific tuning, performance guidelines, recommendations, and specific setup issueswould be provided and communicated directly by IBM to the customer. We are currently notaware of any Documentum specific LPAR setup issues. We expect the customer to performrelevant use case scenario based pre-production testing on LPAR. This support assumes thatthese tests with relevant configurations perform successfully prior to going into production. Ifthe issue is determined to be related to incompatibility of the LPAR environment, EMC and thecustomer will jointly pursue with IBM for resolution.

Sun Microsystems support

The following table lists the Sun Microsystems product versions supported on specific operatingsystem(s).



Table 13. Sun Microsystems support

Product Operating system ProcessorSun Microsystems SolarisZones [1] Solaris 10 UltraSPARC

Sun Microsystems LogicalDomains (LDOM) Solaris UltraSPARC

Note: The following specific note indicated by [ ] applies to the Sun Microsystems support table:

[1] Non-global zone is not supported for Index Server.

Citrix support

The following table lists the Citrix product versions supported on specific operating system(s).

Table 14. Citrix support

Product versions Operating system Processor

Citrix XenApp 5.0 Release 2 [1] Windows Server 2003 SP2(32-bit version) IA-32, x64

Citrix XenApp 5.0 Release 2 [1] Windows Server 2008 R2 (64-bitversion) IA-32, x64

Note: The following specific note indicated by [ ] applies to the Citrix support table:

[1] Citrix Presentation Server 4.5 FP2 was renamed to XenApp 5.0.

Note: The following general notes apply to the Citrix support table:• IA-32 = Intel Architecture 32-bit


Siteminder support

eTrust Siteminder Policy Server 6.0 SP5 is supported for all supported web application servers andoperating systems, except there is no Firefox browser support. ’libstdc++-libc6.2-2.so.3’ package isrequired to load netegrity plugin on SUSE Linux 11.

RSA support

RSA Access Manager 6.0.4 is supported for all supported web application servers and operatingsystems.



Native 64-bit support

Documentum 6.5 and later versions provide native 64-bit support such that 64-bit Documentumapplications can run on 64-bit operating systems where 32-bit browsers are used.

Prerequisites to run Documentum 6.5 and later products in the native 64-bitmode

You must ensure that your 64-bit environment comprises the following prerequisite componentsbefore you run the Documentum 6.5 and later products:• 64-bit processor

• 64-bit operating system

• 64-bit Java Virtual Machine

• 64-bit web application server (if needed). Ensure that the web application server is bundled with64-bit Java Virtual Machine.

64-bit support in browser environment

Documentum 6.5 and later versions provide support for WDK-based applications that are deployedon a 64-bit application server installed on a 64-bit operating system. However, Documentum 6.5 andlater versions do not support accessing any WDK-based application in a 64-bit client environmentwhere a 64-bit browser is used. Documentum 6.5 and later versions support only 32-bit browsers ina 64-bit client environment.

The native 64-bit support takes full advantage of 64-bits of address space and the concurrent use ofmore than 4 GB of executable memory.

64-bit support in web application server environment

Documentum 6.5 and later versions continue to support 32-bit versions of the Microsoft Windowsoperating system. In the 64-bit domain, Documentum 6.6 and later will support 64-bit versions ofWindows Server 2003 SP2 x64 Edition and Windows Server 2008 R2 x64 Edition.

IPv6 support

Documentum 6.5 and later now supports dual-stack (IPv4 or IPv6) and native IPv4 operation. Inaddition to this, Documentum 6.5 and later products which are Java based applications also supportnative IPv6 operation. Support for dual-stack operation enables Documentum 6.5 and later productsto use the appropriate protocol (IPv4 or IPv6) when communicating with third-party products andother Documentum products.

Documentum Foundation Classes determines the operating mode, and by default, DFC is configuredfor dual-stack and native IPv6 operation. The Documentum Foundation Classes Installation Guideprovides information on how to configure DFC for native IPv4 operation.



Note: Information on protocol support for third-party products is provided in the third-partyproduct documentation.

Table 15. Documentum Administrator IPv6 compliance

ProductDual-Stack(IPv4 & IPv6) Native IPv6

Documentum Administrator X X

Note: The X symbol denotes the support started with 6.5 release.

Applet certificates

Applet code signing certificates shipped with Documentum applications are signed before theexpiration date of the certificate. If you are running JRE Java 6 update 18 or later, the certificates donot expire and no warning messages are displayed. If you are running an earlier version of JRE andtry to download the applet to a client machine for the first time but the digital certificate has expired,a warning message indicating that the certificate has expired, is displayed.

If that happens, you can choose one of the following options:• Click Run in the warning message window to accept the previously validated certificates. Thecode and digital signature are valid because the date when the code was signed was prior to thecertificate expiration date.

• Replace the expired applets with the new certificates provided in advance of the expiration date.

Table 16. Applet certificates of Webtop

Applet name Certification type Expiry dateUCF AppletsContentXfer AppletsFile Selector Applets

JavaMicrosoft 11/02/2012

Table 17. Applet certificates of Documentum Application Connectors

Applet name Certification type Expiry dateAppConnectors Installer Executable Microsoft 11/04/2011

Table 18. Applet certificates of Web Publisher

Applet name Certification type Expiry dateRules Editor AppletContent Editor AppletEditLive Jar Java 11/02/2012



Table 19. Applet certificates of TaskSpace

Applet name Certification type Expiry dateUCF AppletsContentXfer AppletsFile Selector Applets

JavaMicrosoft 11/02/2012

Cross-product dependencies andinteroperabilityThis section lists Documentum products that are depended on in order to achieve a basic level offunctionality and lists related Documentum products that enhance overall functionality.

You may have to install some of the listed products on separate host or client machines due todifferences in the Documentum Foundation Classes versions included with those products. Beforeinstalling a product, check the product’s Release Notes for supported configurations.

The 32-bit version of Documentum 6.5 and later products can run in the 32-bit native mode and the64-bit compatibility mode. However, the 64-bit version of Documentum 6.5 and later products canrun only in the 64-bit native mode.

One of the following product versions is a prerequisite for Documentum Administrator:• Content Server 5.3, 5.3 SPx, 6, 6 SP1, 6.5, 6.5 SP1, 6.5 SP2, 6.5 SP3, 6.6

Note: Regardless of whether the Content Server version is 5.3, 5.3 SPx, 6, 6 SP1, 6.5, 6.5 SP1, 6.5 SP2,6.5 SP3 or 6.6, WDK-based applications require the presence of a Content Server 6, 6 SP1, 6.5, 6.5 SP1,6.5 SP2, 6.5 SP3 or 6.6 global registry repository in order to function properly.

Embedded productsInstalling EMC Documentum products includes the following additional products.

For Documentum Administrator:• Documentum Foundation Classes 6.6




Chapter 4Fixed Problems

Within two weeks of the release, a list of the fixed problems in the release will be posted on the EMCPowerlink website (http://powerlink.emc.com). You must have a software support agreement to login and access the list of fixed bugs.

To view the list of fixed problems:

1. Log in to the Powerlink website.

2. Select the Search Support tab, and then click Advanced Search.The Search Support page appears.

3. Under the Search Support heading, click All Support Resources and select Documents fromthe list.

4. In the text field, type the product name.

5. Click Show Advanced Options to expand the Advanced Options pane.

6. Under Document Type, select Fixed Bugs List.

7. Click Search at the bottom of the Advanced Options pane.

8. Scroll down to see the search results listing the Fixed Bugs documents for each release of theproduct.

9. Click the document name to view the file.

Fixed problems for version 6.6This section describes problems that were fixed in Documentum Administrator 6.6.

Classloader used by the BOF2 objects are not loadingthe expected xml libraries (141153, 152781)

The classloader used by the BOF2 objects on some application servers, such as WebSphere, hasproblems loading the expected xml libraries and displays a blank page (141153) or throws an errormessage (152781). To resolve these issues in Documentum Administrator, copy xml.jar fromWebsphere/AppServer/java/jre/lib directory to Documentum Administrator web-inf/lib directory.



Fixed Problems

Invisible federation object using DA (164278/DA-892)

After successfully creating a federation object in Documentum Administrator, the object does notappear on the Federation list page. To resolve this issue, restart the repository and docbroker aftercreating a federation object.

No change in a_next_invocation_date attribute whilechanging Start Date and Time job attribute(DA-1146)

When you change the Start Date and Time attribute of a job in Documentum Administrator, thechanges are not reflected in the a_next_invocation_date attribute.

Configuration of LDAP with SSL fails (DA-2804)

The validation of the SSL test connection for 32-bit machines succeeds, but fails for 64-bit machinesfor LDAP configuration. LDAP SSL configuration is not supported in native 64-bit mode.

Upgrading from 5.3 SP6 to 6.5 SP2 repository fails(DA-3375)

When you upgrade from 5.3 SP6 repository to 6.5 SP2 repository, the Presets.dar,ResourceAgentsRegistry.dar, and Adminaccess.dar files are not installed. Therefore, Admin AccessSet and Resource Agent functionality of Documentum Administrator do not work.

Mismatch in count in Files column of categories(DA-3388)

When the processing of DocSet is done in the Production view, the number of documents in theFiles column of the categories in the Test view increments resulting in a count mismatch. Also, nodocuments are found in categories in Test view. This behavior is seen only on Windows/Oraclesupported combination.

Repository properties sharing the same name but adifferent type cannot be added in the property mappingattribute of the LDAP configuration object (DA-3666)

Using repository properties with same name for different types in the property mapping attribute ofthe LDAP configuration object generates an error. This behavior is seen only when you try to connect


Fixed Problems

Documentum Administrator 6.5 SP3 to a Content Server 6.5 SP2 or earlier. This behavior is fixedin Documentum Administrator 6.6.


Fixed Problems


Chapter 5Known Problems and Limitations

This section identifies problems and limitations that may affect your use of the product.

Note: This section and the Technical Notes section may refer to platforms or features that are notsupported for this release of your product. Check Chapter 3, Environment and System Requirementsto verify requirements.

EMC Documentum makes the latest information about customer-reported issues and knownproblems available on the Powerlink website (http://powerlink.emc.com). You must have a softwaresupport agreement to log in and access the list of issues.

Note: EMC Documentum has recently migrated to a new defect tracking system. As a result,problems and limitations in this chapter may include the legacy tracking number (a numericreference), the new tracking number (an alphanumeric reference), or both references.

Known problemsThis section describes known problems in EMC Documentum software that may affect your useof the product.

Migration policy trace files (80728)

Documentum Administrator does not display a dmcl trace file after a new migration policy runssuccessfully. When the trace is switched on the server, all traces go to that file and a separate tracefile is not generated.

Reordering assignment policy rules (80839)

When editing the rules of an assignment policy, do not reorder the rules. The changes are applied tothe wrong rule.



Known Problems and Limitations

Documents locked after a user or group is reassigned(CS-3839)

If you reassign a user or group, documents locked by that user or group remain locked, even if youuse the option to unlock the objects.

Creating an SSL-enabled LDAP configuration objectfails on HPIA Platform (DA-648/170896)

Creating an SSL-enabled LDAP configuration object using Documentum Administrator fails on theHPIA platform.

To create an SSL-enabled LDAP configuration object, perform the following steps:1. Create a non-SSL LDAP config object using Documentum Administrator.

2. Execute the following IAPI commands to enable SSL:API>retrieve,c,dm_ldap_config where object_name =’LDAP config object name’API>set,c,l,ssl_modeSET>1API>set,c,l,ssl_portSET>636 (SSL port number)API>set,c,l,certdb_locationSET>ldapcertdb_loc (ldap cert db location)API>save,c,l

Index Agent MBean log file is not downloaded(DA-737/153922)

When users click to view All events in the Log tab of an index agent MBean, all events should belisted. Instead, the download log file operation throws an error for the index agent MBean.

Deployment fails on Windows Server 2003 SP2(32-bit version)/Oracle AS 10g Release 3 (10.1.3.3.0)environment (DA-742/154754)

The Documentum Administrator WAR file deployment fails on Windows Server 2003 SP2 (32-bitversion)/Oracle AS 10g Release 3 (10.1.3.3.0) environment. The system displays a blank page witherror message as ’Object Expected, Syntax error’ when users access the DA URL using InternetExplorer.

The workaround for the Oracle application server environment is to comment out the following linesin DA\WEB-INF\web.xml:<init-param><param-name>wdk_cache_control_redirect_includepages</param-name><param-value><![CDATA[(\.jar)$]]></param-value>



</init-param>

Changing the owner of an already assigned ACL doesnot change the acl_domain of the affected objects(DA-1264/118785)

After the owner of an ACL is changed, the acl_domain of this acl associated with an object does notreflect the updated owner. The object’s acl_domain has not been updated to the new owner, but isstill pointing to the old owner. This can cause security issues when viewing the object associatedwith the updated ACL.

Two references to the same group appear afterreassigning (DA-1468/136710)

As an example, groupA and groupB belong to admingroup. After reassigning groupA to groupB,two references to groupB appear as members of admingroup.

Changing the ACL or home cabinet for a user requiressuperuser privileges (DA-3365)

Only a superuser can change the ACL or home cabinet of a user. If you are logged into a repositorywith system administrator privileges and edit an user account, you can select a different ACL orhome cabinet for the user. However, when you save the changes, they are not implemented andthe system does not display an error message.

Object type dm_message_archive lost in docsetproperties (DA-3607)

When you create a new docset with an object type dm_message_archive and then save it, the objecttype is lost. This behavior does not occur in all other object types except dm_message_archive.

Replacing, deleting or revoking of LDAP databasecertificates is not supported (DA-3620)

Replacing , deleting or revoking of LDAP database certificates in the LDAP certificate database isnot supported using the LDAP Certificate Management functionality. To update the certificates,



manually remove the existing LDAP certificate database on the Content Server, restart the methodserver, and import the new certificates using Documentum Administrator.

Removing a role member after a search generatesruntime exception error (DA-3854)

If you select a role and perform a search for a user, the system displays the user in the searchresult. If you then select the user in the search result and try to delete the user, the system throws aruntime exception. This behavior happens for members of any role that contains a mix of groupswith more than 10 users.

Known problems common to all WDK applications

For information about WDK applications, refer to theWDK and Webtop Release Notes.

LimitationsThis section describes limits on the usability of current functionality. The limitations may be part ofthe product design or may result from issues with associated third-party products.

Menu behavior

When you click a menu under Internet Explorer, you can navigate the submenus by holding themouse button and moving the mouse pointer. When you click a menu under Netscape Explorer,you must click on the submenu picks.

Failover

If the server to which you are connected fails, Documentum Administrator does not automaticallyreconnect to the repository. You must reconnect manually.

File store and job names

Do not use single quotation marks in file store and job names. Single quotation marks in file store andjob names can cause exception errors when a user views the associated Properties page.



Viewing log files

Viewing large log files in Documentum Administrator can take several minutes and the browseror product appears to hang.

Very large log files are truncated when displayed in Documentum Administrator.

Inherited default ACL must have Read access

The default_acl attribute of the Content Server server config object specifies how Content Serverassigns default access control lists (ACLs) to newly created objects, including categories. One possiblevalue for this attribute causes the server to assign the default ACL associated with the user whocreates the new object. If Content Server is configured to inherit the default ACL from the user, thedefault ACL associated with the user who enables CIS functionality in the repository must grantat least Read access to all CIS users.

Simple search fails with an error message in severalminutes after Index Server has restarted (DA-3627)

After restarting the Index Server, simple search can fail initially despite the status of the Index Serverdisplays ’Running’ in Documentum Administrator. The Index Server requires several minutes to startup all components, including search components processes. Wait until all Index Server componentsare up and running before using the simple search feature.

Failover not supported in clustered environments

You can install Documentum Administrator in a clustered environment; however, failover is notsupported.

Compatibility limitations between CIS server and CI APIclients

The development of some new features caused compatibility limitations between CIS server and CIAPI clients.

CIS server 6.5 requires CI API clients, such as Documentum Administrator, version 6 SP1 or later. CISserver 6 SP1 requires CI API clients 6 SP1. CIS server 6 requires CI API clients 6.



Error on folder names with single quotes (CIS-164)

When defining document sets in the Content Intelligence node, an error occurs when you select afolder or cabinet with a name that includes a single quote character. The single quote character isa reserved character in DQL syntax.

Selector pages

If you have items you want to add selected on a selector page and you click OK instead of clickingAdd, Documentum Administrator exits to the previous page and you lose the selections.

Server and connection broker logs

You cannot manually delete server or connection broker logs from Documentum Administrator.Ensure that you set the Log Purge job to active and set a regular schedule for it.


Chapter 6Technical Notes

This section provides configuration and usability notes for current product features.

Customization not supportedCustomizing Documentum Administrator is not supported.

Adding connection brokersThe ability to add a connection broker using Documentum Administrator is limited to users withSystem Administrator or Superuser privileges. If you need to make more connection brokers and therepositories to which they connect available to users, you can also update the dfc.properties in da.earlocated in /web-inf/classes folder and re-jar the ear file.

Displaying job trace filesTurning on tracing in the dfc property on the Content Server host overrides DocumentumAdministrators ability to display a trace file. If Documentum Administrator does not display thetrace file after a job runs successfully, examine the dfc property file on the Content Server host. If thetrace_file parameter is set, remove it and the trace_level parameter.

View Jobs buttonDocumentum Administrator displays a View Jobs button at the bottom of each page next to theView All Messages button. Clicking the View Jobs button displays information about asynchronousWDK operations, not repository or server jobs.


Technical Notes

Repositories with Trusted Content ServicesenabledTo access a repository that has Trusted Content Services enabled, modify dfc.properties in da.earlocated in /web-inf/classes folder and add the following line:dfc.session.secure_connect_default=try_secure_first

Re-jar the ear file.

Accessibility options not supportedDocumentum Administrator is built using components from WDK and Webtop. Webtop supportsthe accessibility options, which present menu choices as clickable links on the primary page for eachWebtop function. When you access Documentum Administrator and choose accessibility optionsduring login, similar links are displayed. However, Documentum Administrator does not supportthe accessibility options.

User privilegesTasks performed using Documentum Administrator include creating or modifying objects, enablingauditing, and initiating site publishing jobs. Different tasks require different user privilege levels.For example, to create a site publishing configuration (now called as content delivery configuration),you must have Superuser privileges. You must have config audit privileges to configure auditing,view audit privileges to view audit trails, and purge audit privileges to remove audit trails from arepository.

A user who connects to Documentum Administrator may not have sufficient privileges to performadministration tasks, but the user is still able to navigate Documentum Administrator and viewthe available administration options.

The Administrator Access chapter inDocumentum Administrator User Guide contains more informationabout this functionality.

Reassigning users objectsReassigning a users objects in the repository does not automatically deactivate the user in therepository. To deactivate the user, from the Users list page, select the user, and on the users Infopage, click Inactive.

Japanese Documentum AdministratorThe Documentum Administrator version 6.6 interface is localized for Japanese.


Technical Notes

LDIF filesOn Japanese and Korean Windows hosts, LDIF files used to import users should be saved in UTF-8format before importing the files.

LDAP configurationsWhen the deactivate_user option is enabled in an LDAP configuration and a user is deactivatedin the LDAP server, the LDAP synchronization job disables the user in the repository by settingthe user_state attribute to 1. When the user is reactivated in the LDAP server, the next LDAPsynchronization job reactivates the user in the repository by setting the user_state attribute to 0.

Audit events in new repositoriesIf you view audit events in a newly-created repository, you may not see any events because the datadictionary job has not completed. The events appear after the data dictionary job completes.

Assignment policiesA user without proper permissions on a policy is not allowed to create a content file that qualifiesto the rules in the policy. In this scenario, the policy is executed, and the user is not allowed tocheck in the document.

Documentum resource agentsUse Documentum Administrator to manage Documentum JMX resources. The JMX service URLsfor ACS and BOCS resource agents are created during Content Server installation. The tablebelow lists the JMX URLs for resource agents accessed through the Resource Management node inDocumentum Administrator. The host is the machine hosting the agent and the port is the portused to communicate with the agent.

Table 20. JMX Service URLs

Product URL Default Port

ACS service:jmx:rmi:///jndi/rmi://<host>:<port>/acs

9081

BOCS service:jmx:rmi:///jndi/rmi://<host>:<port>/bocs

8087


Technical Notes

DMS service:jmx:rmi:///jndi/rmi://<host>:<port>/dms

8490

Index Agent service:jmx:rmi:///jndi/rmi://<host>:<port>/indexagent

9201

Enabling or disabling the write modeIn the 6.5 SP1 release, the ACS Write property is enabled by default. You can disable the ACS Writeproperty using either of the following ways:1. You can set the ACS Write property of the Distributed Transfer Settings to None to disable it.

Or

2. You can change the setting in the XML file of the web application (<webapps-root>\da\wdk\app.xml) as shown in the following example:<accelerated-write><enabled>true</enabled><bocs-write-mode>default-sync</bocs-write-mode><allow-override-bocs-write-mode>false</allow-override-bocs-write-mode>

</accelerated-write>

Note: If you change the setting in the XML file of the web application (<webapps-root>\da\wdk\app.xml), then you must restart the web application server.

Blank page error on deploying DADeploying DA on a WebSphere 6.1 environment throws a blank page due to classloading constraintviolation. To resolve this, add a new property to dfc.properties as below:With PARENT_LAST, dfc.bof.classloader.enable_extension_loader_first = false


Technical Notes

With PARENT_FIRST, dfc.bof.classloader.enable_extension_loader_first = true


Technical Notes


Chapter 7Documentation

This section describes the documentation related to this product.

Documentum Administrator documentation setThese documents comprise the Documentum Administrator documentation set for this versionof the product:

• Documentum Administrator Release Notes, Version 6.6 (this document)

• Documentum Administrator Deployment Guide, Version 6.6

• Documentum Administrator User Guide, Version 6.6

Obtaining the correct documentationThe Powerlink website (http://powerlink.emc.com) contains the downloadable packages for specificproduct versions along with the release notes, installation guide, and other relevant documentationassociated with the product version. To locate product documentation, navigate to Support >Technical Documentation and Advisories > Software ~ D ~ Documentation, then select the productname and version number.

Note: The majority of Content Management products are listed under Software D > Documentum?, where ? = a letter, or letters, in the alphabet.

Product documentation that is available online from the application (as online help) does not appearas a separate item; it is automatically downloaded and installed with the software.



Documentation


Chapter 8Software Media, Organization, andFiles

This section describes the media in which the software is available, the organization of the productcomponents in the available media, and the file names for all available product components whichcan be downloaded.

Software mediaThis product is available as an FTP download from the Powerlink website (http://powerlink.emc.com).You should have received instructions through email regarding how to download products.

OrganizationThe Powerlink website (http://powerlink.emc.com) provides access to https://emc.subscribenet.com/control/dctm/index, which provides a complete listing of the products available for download.

FilesThe following modules/files comprise the contents of this release:

• Deployment file (for example, da.war)

• Documentum Administrator Release Notes, Version 6.6

• Documentum Administrator Deployment Guide, Version 6.6

• Documentum Administrator User Guide, Version 6.6




https://emc.subscribenet.com/control/dctm/index

https://emc.subscribenet.com/control/dctm/index

Software Media, Organization, and Files


Chapter 9Deployment

Please refer to the Documentum Administrator Deployment Guide for complete deployment instructions.


Deployment


Chapter 10Troubleshooting and Getting Help

Documentum’s technical support services are designed to make your deployment and managementof Documentum products as effective as possible. The EMC Customer Support Guide provides athorough explanation of Documentum’s support services and policies. You can download thisdocument from the Powerlink website (http://powerlink.emc.com) by navigating to: Support >Request Support > Customer Support Guide.