RELEASE_NOTES

           Google Search Appliance Connector for Documentum
                           Release Notes

This document contains the release notes for Google Search Appliance
Connector for Documentum. This connector supports EMC Documentum Content Server.
The following sections describe the release in detail and provide information
that supplements the main documentation.

For information about the latest version of the Connector for Documentum,
see the version 4 overview page and GitHub project:

    http://googlegsa.github.io/adaptor/index.html

    https://github.com/googlegsa/documentum

For more about version 3, see the version 3 GitHub project:

    https://github.com/googlegsa/documentum.v3

Release 3.4.0, October 29, 2015
===============================

Introduction
------------
This is a maintenance release that improves security and quality
without adding any new functionality. Users of previous releases are
encouraged to upgrade.

Known Issues
------------
23774328 - Modified permissions on documents are not detected.
           When permissions are modified on documents, the r_modify_date
           attribute of the document is not updated. Since the queries depend
           on r_modify_date to detect changes, these updates are not detected.
           This issue is fixed in version 4.1.

Issues Fixed Since 3.2.10
-------------------------
23774318 - Disabled users can see Documentum search results. Filter out
           disabled users in group lookup by checking for user_state = 0
           “indicating a user who can log in”.

23226447 - In Documentum version 7.0 and later, the DATETOSTRING function
           uses UTC rather than server time. This results in getting back
           a timestamp in non-server timezone, and when this is used in DQL
           using DATE function where it is interpreted as server time,
           wrong results are returned.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 3.2.10 may be
used with this version. This version works with Connector Manager
version 3.2.2 or later. Earlier versions of the Connector Manager will
not work correctly with this version of the connector.

Java SE versions 6, 7, and 8 are supported.

This product is designed to function with EMC Documentum Content Server  
versions 6.6 through 7.2. A compatible version of EMC Documentum Foundation
Classes (DFC) is required.. Documentum Content Server 6.5 is no longer
supported.


Release 3.2.10, March 20, 2015
==============================

Introduction
------------
This is a maintenance release that improves security and quality
without adding any new functionality. Users of previous releases are
strongly encouraged to upgrade.

Issues Fixed Since 3.2.8
------------------------
19736255 - Documentum user ACEs should use the user_login_name
           attribute rather than the CN RDN of the user_ldap_dn
           attribute. This is consistent with authentication, which
           uses the user_login_name.

19732599, 15450112 - Group lookup fails and user ACEs are constructed
           incorrectly if the user's user_ldap_dn attribute does not
           contain the user domain.

           A new advanced config property is introduced to support
           this configuration:

           <property name="windows_domain" value="configdomain"/>

           The configured value ("configdomain") is used as the domain
           for all users with no LDAP domain, in ACLs and for group
           lookup. If the primary verified identity (PVI) of the
           search user includes a domain, it must match the configured
           windows_domain value.

19484996 - The connector handles timestamps incorrectly if the
           connector host is in a different time zone from the
           Documentum Content Server. Depending on whether the client
           local time was earlier or later than the server local time,
           the connector would either send the same IDs to the GSA
           repeatedly for adds and deletes, or it would repeatedly
           skip adds and deletes in certain time windows.

17737679 - The connector has an unclosed collection. This may use
           extra resources and may lead to other problems.

13218191 - The Advanced configuration section on the configuration
           form did not load on GSA 7.2 when the Advanced
           configuration checkbox was clicked.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 3.2.8 may be
used with this version. This version works with Connector Manager
version 3.2.2 or later. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions 6.5,
6.6 and 6.7, including service packs. EMC Documentum Foundation Classes
(DFC) 6.5 or later is required. Java 6 or later is required.


Release 3.2.8, July 8, 2014
===========================

Introduction
------------
This is a maintenance release that improves security and quality
without adding any new functionality. Users of previous releases are
strongly encouraged to upgrade.

Summary of Changes
------------------
  * Documentum Content Server version 6.0 is no longer supported with
    the connector.

Issues Fixed Since 3.2.4
------------------------
14417806 - Documentum connector incorrectly marks dm_world.
           It was marked as global user, instead of local group.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 3.2.4 may be
used with this version. This version works with Connector Manager
version 3.2.2 or later. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions 6.5,
6.6 and 6.7, including service packs. EMC Documentum Foundation Classes
(DFC) 6.5 or later is required. Java 6 or later is required.


Release 3.2.4, March 17, 2014
=============================

Introduction
------------
This is a maintenance release that improves security and quality
without adding any new functionality. Users of previous releases are
strongly encouraged to upgrade.

Issues Fixed Since 3.2.2
------------------------
13399766 - Documentum connector SQL and LDAP injection vulnerability
           in group lookup. With a carefully constructed username,
           which must be validly authenticated by the connector or
           another configured authentication mechanism, the connector
           group lookup might return the group membership for a
           different user.

13309424 - Documentum connector leaks a session if group lookup query
           fails.

13253159 - When multiple domains are used, it is possible for the
           Documentum connector to return groups for the wrong user
           when configured for group lookup only.

13109953 - Documentum connector does not support Kerberos realms, DNS
           domains, or uppercase domain names for group lookup.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 3.2.2 may be
used with this version. This version works with Connector Manager
version 3.2.2 or later. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions 6.0,
6.5, 6.6 and 6.7, including service packs. EMC Documentum Foundation
Classes (DFC) 6.0 or later is required. Java 6 or later is required.


Release 3.2.2, October 30, 2013
===============================

Introduction
------------
This is a maintenance release that improves quality without adding any
new functionality. Users of previous releases are encouraged to upgrade.

Issues Fixed Since 3.2.0
------------------------
11416343 - Documentum sessions not properly released, which was
           introduced in 3.2.0 release.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 3.2.0 may be
used with this version. This version works with Connector Manager
version 3.0.0 or later. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions 6.0,
6.5, 6.6 and 6.7, including service packs. Java 6 or later is required.


Release 3.2.0, Oct 14, 2013
============================

Introduction
------------
This is a major release with new features. Users of previous releases are 
encouraged to review the changes below to determine whether to upgrade.

Summary of Changes
------------------
  * Documentum Content Server version 5.3 is no longer supported with the
    connector.

  * Java SE 5.0 is no longer supported. Java 6 or later is required.

  * Fixed issue 4326053: Per-URL ACLs for Documentum connector.

    Connector now includes ACL information in feeds. Audit trail needs to be
    turned on for dm_acl object for dm_save, dm_saveasnew and dm_destroy events.
    Audit trail can be turned on using Documentum Administrator.

    Supports LDAP synchronized users with domain in Documentum. Connector
    uses domain information from user_ldap_dn field of dm_user object. Only
    first domain information is used, for example, for a user_ldap_dn value of
    "CN=John Doe, cn=users,dc=corp,dc=example,dc=com", domain value of "corp"
    is used.

  * Fixed issue 8509824: Support access control features in EMC Documentum
    Trusted Content Services.

    Supports AccessRestriction, RequiredGroup and RequiredGroupSet.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 3.0.4 may be
used with this version. This version works with Connector Manager
version 3.0.0 or later. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions 6.0,
6.5, 6.6 and 6.7, including service packs. Java 6 or later is required.


Release 3.0.4, Dec 6, 2012
==========================

Introduction
------------
This is a maintenance release that improves quality without adding any
new functionality. Users of previous releases are encouraged to upgrade.

Summary of Changes
------------------
  * Fixed issue 7608960: Documentum Connector fails to handle large
    authorization requests coming from GSA. Authorization requests for
    more than 495 documents could fail, and deny access to all of the
    documents in the request.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 3.0.0 may be
used with this version. This version works with Connector Manager
version 3.0.0 or later. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions 5.3,
6.0, 6.5, and 6.6, including service packs.


Release 3.0.0, Oct 18, 2012
===========================

Introduction
------------
This is a maintenance release with no significant changes. Users of
previous releases are encouraged to review the changes in the
Connector Manager version 3.0.0 and other connectors. See the product
website for a complete description.

Summary of Changes
------------------
  * Fixed issue 6513826: Add less verbose logging level for MBean messages.
  * Updated the tests to work with Connector Manager version 3.0.0.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 2.8.0 may be
used with this version. This version works with Connector Manager
version 3.0.0. Earlier versions of the Connector Manager
will not work correctly with this version of the connector. This
product is designed to function with EMC Documentum Content Server
versions 5.3, 6.0, 6.5, and 6.6, including service packs.


Release 2.8.0, May 26, 2011
===========================

Introduction
------------
This is a maintenance release with no significant changes. Users of
previous releases are encouraged to review the changes in the
Connector Manager version 2.8.0 and other connectors.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 2.6.6 may be
used with this version. This version works with Connector Manager
version 2.8.0. Earlier versions of the Connector Manager
will not work correctly with this version of the connector. This
product is designed to function with EMC Documentum Content Server
versions 5.3, 6.0, 6.5, and 6.6, including service packs.

Users upgrading from versions prior to 2.4.0 should read the release
notes for the earlier versions.


Release 2.6.6, Dec 7, 2010
==========================

Introduction
------------
This is a maintenance release that improves quality and reliability.
Users of previous releases are encouraged to upgrade. See the product
website for a complete description.

Summary of Changes
------------------
For the latest details on the changes, see http://code.google.com/p/google-enterprise-connector-dctm/issues/list?can=1&q=label%3AMilestone-Release_2.6.6

  * Fixed issue 54 to allow the r_object_id property to be included on
    the configuration form and indexed.
  * Fixed issue 69 to optionally index the location of documents as a
    property named google:folder. The values are taken from the
    r_folder_path values of a document's enclosing folders. This
    property can be included on the configuration form.
  * Fixed issue 73 to fix DFC_BOF_COULDNT_ADOPT_SESSION errors during
    authorization. This would lead to authorization failures and
    documents missing from the search results.
  * Fixed issue 75 to use &#39; instead of &apos; when escaping single
    quotes. Previously, when adding or editing a connector instance
    using Internet Explorer, if the additional where clause included a
    quoted string and clicking the Save Configuration button returned
    a configuration error, then Internet Explorer would not resolve
    the &apos; entity. This would lead to further configuration errors.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 2.6.0 may be
used with this version. This version works with Connector Manager
version 2.6.6. Earlier versions of the Connector Manager
will not work correctly with this version of the connector. This
product is designed to function with EMC Documentum Content Server
versions 5.3, 6.0, and 6.5, including service packs.

Users upgrading from versions prior to 2.4.0 should read the release
notes for the earlier versions.


Release 2.6.0, Jun 14, 2010
===========================

Introduction
------------
This is a maintenance release with no significant changes. Users of
previous releases are encouraged to review the changes in the
Connector Manager version 2.6.0 and other connectors. See the product
website for a complete description.

Summary of Changes
------------------
For the latest details on the changes, see http://code.google.com/p/google-enterprise-connector-dctm/issues/list?can=0&q=label%3AMilestone-Release_2.6.0

  * Fixed issue 71 to avoid DFC log messages about Google-specific SPI
    properties.
  * Updated the tests to work with Connector Manager version 2.6.0.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 2.4.0 may be
used with this version. This version works with Connector Manager
version 2.4.0 through 2.6.0. Earlier versions of the Connector Manager
will not work correctly with this version of the connector. This
product is designed to function with EMC Documentum Content Server
versions 5.3, 6.0, and 6.5, including service packs.

Users upgrading from versions prior to 2.4.0 should read the release
notes for the earlier versions.


Release 2.4.0, Nov 16, 2009
===========================

Introduction
------------
This is an upgrade release with some enhancements. Users of previous
releases are encouraged to upgrade. See the product website for a
complete description.

Summary of changes
------------------

For the latest details on the changes, see http://code.google.com/p/google-enterprise-connector-dctm/issues/list?can=1&q=label%3AMilestone-Release_2.4.0

  * Fixed issue 46 to display more useful error messages in the Admin
    Console when DFC is misconfigured.
  * Fixed issue 61 to avoid errors editing the connector configuration
    in the Admin Console when the configuration was outdated, such as
    when the Documentum user's password has been changed.
  * Fixed issue 65 to support excluding documents completely based on
    the content type. Previously the only option was to skip the content
    but index the metadata.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 2.0.2 may be
used with this version. This version works with Connector Manager
version 2.4.0. Earlier versions of the Connector Manager will not work
correctly with this version of the connector. This product is designed
to function with EMC Documentum Content Server versions 5.3, 6.0, and
6.5, including service packs.

Version 2.4.0 requires Java SE 5.0, and hence requires DFC 5.3 SP4 or
later. It also uses a new method in DFC 5.3.

Customers upgrading an existing installation from a version 1 release
must stop Tomcat and rename the EMC_Documentum_Content_Server_VERSION
directory, where VERSION is either 5.2.5_5.3 or 6.0, to
EMC_Documentum_Content_Server before beginning the upgrade. This
directory can be found in the WEB-INF/connectors directory of the
connector manager application.

Customers with custom connectorInstance.xml files created for version
1.3.2 or earlier must update those files in order to use the Advanced
Configuration section of the configuration form in the admin console.
Please see issue 52 for details, and contact Google Enterprise Support
if you need assistance.

http://code.google.com/p/google-enterprise-connector-dctm/issues/detail?id=52


Release 2.0.2, Sep 22, 2009
===========================

Introduction
------------
This is a maintenance release that improves quality, reliability, and
performance without adding any new functionality. All users of
previous 2.0.x releases should upgrade to this release. See the
product website for a complete description.

Summary of changes
------------------

For the latest details on the changes, see http://code.google.com/p/google-enterprise-connector-dctm/issues/list?can=0&q=label%3AMilestone-Release_2.0.2

  * Fixed issue 53 to handle user authorization in multiple server
    deployments.
  * Fixed issue 57 to avoid leaking sessions in the Advanced
    configuration section of the Add Connector page.
  * Fixed issue 60 to use the indexed time_stamp_utc property of
    dm_audittrail instead of the unindexed time_stamp property, for
    better performance.
  * Other changes to minimize the number of DFC sessions used, and to
    increase performance by caching type information.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 2.0.0 may be
used with this version. This version works with Connector Manager
version 2.0.0 through 2.0.2. Earlier versions of the Connector Manager
will not work correctly with this version of the connector. This
product is designed to function with EMC Documentum Content Server
versions 5.3, 6.0, and 6.5, including service packs.

Version 2.0.2 requires Java SE 5.0, and hence requires DFC 5.3 SP4 or
later. It also uses a new method in DFC 5.3.

Customers upgrading an existing installation from a version 1 release
must stop Tomcat and rename the EMC_Documentum_Content_Server_VERSION
directory, where VERSION is either 5.2.5_5.3 or 6.0, to
EMC_Documentum_Content_Server before beginning the upgrade. This
directory can be found in the WEB-INF/connectors directory of the
connector manager application.

Customers with custom connectorInstance.xml files created for version
1.3.2 or earlier must update those files in order to use the Advanced
Configuration section of the configuration form in the admin console.
Please see issue 52 for details, and contact Google Enterprise Support
if you need assistance.

http://code.google.com/p/google-enterprise-connector-dctm/issues/detail?id=52


Release 2.0.0, Jun 15, 2009
===========================

Introduction
------------
This is an upgrade release with some enhancements. Users of previous
releases are encouraged to upgrade. See the product website for a
complete description.

Summary of changes
------------------

For the latest details on the changes, see http://code.google.com/p/google-enterprise-connector-dctm/issues/list?can=0&q=label%3AMilestone-Release_2.0.0

  * Fixed issue 23 to include the full type hierarchy in the indexed
    r_object_type property.
  * Fixed issue 33 to avoid deleting a document when a version is
    deleted. If the current version is deleted, the new current
    version will be reindexed.
  * Fixed issue 40 to avoid a potential infinite loop if the
    checkpoint method throws a DfRuntimeException.
  * Fixed issue 41 to implement TraversalContextAware. The connector
    now uses the MIME type configuration in applicationContext.xml to
    determine whether to send the document content. The connector
    always sends the metadata, even if the content itself is rejected.
  * Fixed issue 52, moving the root_object_type, where_clause,
    included_object_type, and included_meta properties from the
    connectorInstance.xml file to the configuration form in the admin
    console. This dramatically simplifies common configuration
    scenarios.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 1.3.2
may be used with this version. This version works with Connector
Manager version 2.0.0. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions
5.3, 6.0, and 6.5, including service packs.

Version 2.0.0 requires Java SE 5.0, and hence requires DFC 5.3 SP4 or
later.

Customers upgrading an existing installation from a previous release
must stop Tomcat and rename the EMC_Documentum_Content_Server_VERSION
directory, where VERSION is either 5.2.5_5.3 or 6.0, to
EMC_Documentum_Content_Server before beginning the upgrade. This
directory can be found in the WEB-INF/connectors directory of the
connector manager application.

Customers with custom connectorInstance.xml files created for version
1.3.2 or earlier must update those files in order to use the Advanced
Configuration section of the configuration form in the admin console.
Please see issue 52 for details, and contact Google Enterprise Support
if you need assistance.

http://code.google.com/p/google-enterprise-connector-dctm/issues/detail?id=52


Release 1.3.2, Apr 11, 2009
===========================

Introduction
------------

This is a maintenance release that improves quality, reliability, and
performance without adding any new functionality. All users of
previous 1.3.x releases should upgrade to this release. See the
product website for a complete description.

Summary of changes
------------------

  * Fixed issue 26 to avoid an error displaying the configuration form
    when the password was missing.
  * Fixed issue 28 to index metadata only if no content is available,
    or if the content is too large (larger than 30 MB). This also
    supports indexing folders.
  * Fixed issue 31 to use the can_index attribute of the dm_format
    object associated with a document to decide whether to index the
    content.
  * Fixed issue 42 to correctly index repeating ID attributes.
  * Fixed issue 43 to require Read permission during authorization.
    Previous versions only required Browse permission.
  * Fixed issue 45 to add support for Documentum 6.5.
  * Fixed issue 47 to compile the code with debug information.
  * Fixed issue 48 to handle concurrent authentication requests. The
    authentication process was not thread-safe, and multiple
    concurrent requests could lead to errors and the denial of access.
  * Fixed issue 49 to index the canonical google: properties with each
    document.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 1.3.0
may be used with this version. This version works with Connector
Manager version 1.3.2. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions
5.3, 6.0, and 6.5, including service packs.


Release 1.3.0, Jan 11, 2009
===========================

Introduction
------------
This is a maintenance release that improves quality, reliability, and
performance without adding any new functionality. Users of previous
releases are encouraged to upgrade. See the product website for a
complete description.

Summary of changes
------------------
  * Updated to match and take advantage of changes in the connector
    manager SPI. For details see Connector Manager issues 72 and 108.

Version Compatibility
---------------------
Connector instances created using versions 1.0.1 through 1.1.0 r468
may be used with this version. This version works with Connector
Manager version 1.3.0. Earlier versions of the Connector Manager will
not work correctly with this version of the connector. This product is
designed to function with EMC Documentum Content Server versions
5.2.5, 5.3, and 6.0.


Release 1.1.0 r468, Dec 1, 2008
===============================

Summary of changes
------------------
  * Fix Issue 38: parameter dfc.compatibility.allow_weak_disconnect
    required with DCTM6

Version Compatibility
---------------------
This version works with Connector Manager version 1.1.0. This product
is designed to function with EMC Documentum Content Server versions
5.2.5, 5.3, and 6.0.


Release 1.1.0 r463, Oct 27, 2008
================================

Summary of changes
------------------
  * Fix Issue 34: authentication Not Working when connector is used in
    conjunction with the SAML bridge.

Version Compatibility
---------------------
This version works with Connector Manager version 1.1.0. This product
is designed to function with EMC Documentum Content Server versions
5.2.5, 5.3, and 6.0.


Release 1.1.0 r460, Oct 8, 2008
===============================

Summary of changes
------------------
  * PushDelete handled
  * Fix Issue 10: exception thrown when custom metadata of date type
    has a null value
  * Fix Issue 15: the connector sends same few docs to connector
    manager, and crawling stops
  * Fix Issue 16: document extension, size and Mime type added to the logs
  * Fix Issue 17: connector authorization issue linked to sessions not
    correctly closed
  * Fix Issue 19: session leaks visible in the logs
  * Fix Issue 21: exception thrown on documents without content  
  * Fix Issue 32: incorrect date format in push delete

Version Compatibility
---------------------
This version works with Connector Manager version 1.1.0. This product
is designed to function with EMC Documentum Content Server versions
5.2.5, 5.3, and 6.0.


Release 1.0.3, May 23, 2008
===========================

Summary of changes
------------------
  * additional logs of FINE, FINER and FINEST level
  * Fix Issue 16 Add document extension, size and Mime type to log.
  * Fix Issue 17 Search frequent term by a normal user yields no
    results, possible documentum connector authorization issue.
  * Fix Issue 19 Session leaks visible in the logs.

Version Compatibility
---------------------
This version works with Connector Manager version 1.0.3. This product
is designed to function with EMC Documentum Content Server versions
5.2.5, 5.3, and 6.0.


Release 1.0.2, Mar 05, 2008
===========================

Summary of changes
------------------
  * Fix Issue 7 check the value of the customs attributes.

Version Compatibility
---------------------
This version works with Connector Manager version 1.0.3. This product
is designed to function with EMC Documentum Content Server versions
5.2.5, 5.3, and 6.0.


Release 1.0.1, Dec 2007
=======================

Version Compatibility
---------------------
This version works with Connector Manager version 1.0.3. This product
is designed to function with EMC Documentum Content Server version
5.3.


Release 1.0.0, Oct 2007
=======================

Version Compatibility
---------------------
This version works with Connector Manager version 1.0.2. This product
is designed to function with EMC Documentum Content Server version
5.3.