Documentum Content Server 7.3 Patch Notes
Documentum Content Server 7.3 Patch Notes
Content Server
Version 7.3, Patch 35
Patch Notes
Legal Notice
This documentation has been created for software version 7.3, Patch 35.
It is also valid for subsequent software versions as long as no new document version is shipped with
the product or is published at https://knowledge.opentext.com.
Open Text Corporation
275 Frank Tompa Drive, Waterloo, Ontario, Canada, N2L 0A1
Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Support: https://support.opentext.com
For more information, visit https://www.opentext.com
Copyright © 2020 Open Text. All Rights Reserved.
Trademarks owned by Open Text.
Adobe and Adobe PDF Library are trademarks or registered trademarks of Adobe Systems Inc. in
the U.S. and other countries.
One or more patents may cover this product. For more information, please visit,
https://www.opentext.com/patents
Disclaimer
No Warranties and Limitation of Liability
Every effort has been made to ensure the accuracy of the features and techniques presented in this
publication. However, Open Text Corporation and its affiliates accept no responsibility and offer no
warranty whether expressed or implied, for the accuracy of this publication.
Table of Contents
3
Table of Contents
4
Revision History
5
Revision History
6
Chapter 1
Compatibility Updates
All certifications provided in this document are relevant to the current patch release.
After you apply this patch, your product's compatibility with other products will be changed
as follows:
7
Compatibility Updates
8
Chapter 2
Patch Requirements
9
Patch Requirements
10
Chapter 3
Installation
Note: It is recommended to use the Content Server Patch Installer to apply the patch.
Windows Platform
1. Ensure that your system meets any requirements listed in Chapter 2, Patch Requirements.
2. Perform the following steps before running the Content Server Patch Installer:
a. Stop the Java Method Server.
b. Stop the Content Server.
c. Take a backup of files in the %DOCUMENTUM% directory.
3. To apply the patch using the Patch Installer:
a. If you are installing the patch using the patch installer for the first time in an upgraded
environment, rename patch-info.xml, if it is available in the $DOCUMENTUM/patch/
folder.
b. Download the patch package file for Windows and extract it to a temporary directory.
c. Run the following command to start the patch installation:
patch.exe LAX_VM %DOCUMENTUM%\java64\<JAVA_VERSION>\jre\bin\java.exe
Note:
• Change the full name of java.exe accordingly in the command if your Documentum
program directory is different.
• Ensure that you do not rename patch.exe before running the Patch Installer.
• By default, patch.exe runs in the GUI mode. If you want to run it in the Console mode,
add an argument “-i console”:
patch.exe LAX_VM <full name of a 1.8+ java> -i console
11
Installation
d. Start the patch installation with the following command and complete the installation:
• For Linux:
patch.bin LAX_VM $DOCUMENTUM_SHARED/java64/<JAVA_VERSION>/jre/bin/java
• For Solaris:
patch.bin LAX_VM $DOCUMENTUM_SHARED/java64/<JAVA_VERSION>/bin/sparcv9/java
• For AIX:
patch.bin LAX_VM $DOCUMENTUM_SHARED/java64/<JAVA_VERSION>/jre/bin/java
Note:
• Ensure that you select the linux_ora.tar.gz file as the patch Resource File entry to
proceed with Patch installation.
• The Patch installation will run in the GUI mode if your environment supports it.
Otherwise, the Patch installation automatically switches to the Console mode. If you
want to force patch.bin to run in console mode, add an argument -i console to
the command:
patch.bin LAX_VM <full name of a 1.8+ java> -i console
• Ensure that you do not rename patch.bin before running the patch installer.
e. Perform the following tasks after the installation is completed:
a. Start the Content Server.
b. Start the Java Method Server.
c. Start the Index Agent and Index Server (if they exist).
12
Installation
Note:
• Replace $DOCUMENTUM with its actual value.
• Refer to the version.txt file available at the root location of the zip or tar file of your
product to determine the version of the patch you have currently installed.
5. Run the following command from the $DOCUMENTUM/patch/bin directory to deploy
MessagingApp.dar into the repository:
repositoryPatch.sh docbaseName installOwnerName
2. Store the WildFly keystore password in the JKS keystore. Run vault.bat from the WildFly bin
directory.
vault.bat --keystore C:\keystore\JKSVAULT1.store
--keystore-password password_j
--alias Vault --vault-block vb --attribute jca-pass
--sec-attr password --enc-dir C:\keystore\
--iteration 95 --salt ABCD1234
...
...
</extensions>
<vault>
<vault-option name="KEYSTORE_URL" value="C:\keystore\JKSVAULT1.store"/>
<vault-option name="KEYSTORE_PASSWORD" value="MASK-03F2DNtm3kYzHmvARCHo2a"/>
<vault-option name="KEYSTORE_ALIAS" value="Vault"/>
<vault-option name="SALT" value="ABCD1234"/>
<vault-option name="ITERATION_COUNT" value="95"/>
<vault-option name="ENC_FILE_DIR" value="C:\keystore
13
Installation
"/>
</vault><management> ...
4. Replace the value in the SSL identity with the substitution string generated after Vault Block:
by the keystore password in encrypted form.
For example, change the following:
Vault Block:vb
Attribute Name:jca-pass
Configuration should be done as follows:
VAULT::vb::jca-pass::1
keystore-password attribute value should be as follows:
<keystore path="C:\\keystore
jms1.keystore" keystore-password=
"${VAULT::vb::jca-pass::1}
"alias="tomcat1"/>
14
Installation
Note:
• Upgrading Java Method Server to WildFly is a one time procedure. This need not be executed
with every patch. Once upgraded to WildFly in patches, the patch installer will take care of
updating files within WildFly.
• In RCS upgrade, after the WildFly is upgraded, ensure to upgrade the CFS instance in the RCS
environment and then restart the Java Method Server.
• If your are configuring the WildFly 9.x or 11.x server in the HTTPS mode, then you must add the
read-timeout attribute in https-listener. The recommended value for read-timeout is
900000 (15 minutes). For example, add the value as shown in bold:
<subsystem xmlns="urn:jboss:domain:undertow:4.0">
<buffer-cache name="default"/>
<server name="default-server">
<http-listener max-post-size="4096" name="default"
redirect-socket="https" socket-binding="http"/>
15
Installation
16
Installation
b. Update the database_conn attribute in server.ini with the new DSN to indicate the
server to point to the latest DSN.
c. Restart the repository.
Note: Upgrading of Content Server having ODBC 17.2 to Documentum Server 16.4 and all patch
versions up to Documentum Server 16.4 P10 is not supported.
17
Installation
18
Chapter 4
Docker Patch
19
Docker Patch
For example:
<init-param>
<param-name>xhiveaddress</param-name>
<param-value>seamlesscontainerhostname</param-value>
</init-param>
<init-param>
<param-name>Content-Server-Version</param-name>
<param-value>7.3.0170.0122</param-value>
</init-param>
Update dfc.properties with the seamless container details at $Documentum/<WildFly
_Version>//server/DctmServer_MethodServer/deployments/XhiveConnector
.ear/APP-INF/classes.
After you complete seamless upgrade, verify if the patch container functions as expected. Then, you
can shut down the primary container and use patch container.
20
Docker Patch
21
Docker Patch
22
Chapter 5
Uninstalling the Patch
Perform the following steps to uninstall the patch you applied using the patch installer:
1. Stop the Java Method Server and Content Server.
2. Run the following command:
• For UNIX, run the following command in the $DOCUMENTUM/patch/bin folder:
csPatchUninstall.sh
23
Uninstalling the Patch
24
Chapter 6
Fixed Issues
This section identifies issues and limitations that are fixed by applying the patch.
Patches are cumulative. As of its publication date, this document lists the fixes for all released patches
for this product.
25
Fixed Issues
Issue ID Description
CS-122983 When you use the SEARCH DOCUMENT
CONTAINS clause in DQL, it results in an error.
CS-121914 Documentum Server fails to store content to
the S3 storage with the Bytes read is not
equal to contentlength; error.
CS-122880 Removing an attribute from a type with many
attributes results in data corruption.
CS-122862 When version label at position 0 is not a number
during a check-in operation, it results in a stack
dump exception.
CS-122814 When fetching all the dm_jms_config objects
configured for a given server_id from the
repository, Documentum Server generates an
incorrect SQL query for the Oracle database.
CS-121473 When a repository is using Galactic
objectIDs, client applications fail with the
DM_DFC_E_CLASS_NOT_FOUND error.
CS-56026 Failed to create or alter type to add a check or
constraint for a repeating property by DQL.
26
Fixed Issues
CS-119674
27
Fixed Issues
28
Fixed Issues
29
Fixed Issues
CS-118009
You must add the new job argument ignore_warning_message and set it to true before running
the dm_LDAPSynchronization job to avoid creating dmi_queue_items and the warning messages in
job report.
30
Fixed Issues
CS-117584
With this fix, user_state overrides workflow_disabled values which means that if user_state is active
then only workflow_disabled value is considered. If you want to revert to the old behavior, you can
create the WFD_RESET_ON_USER_STATE environment variable and set it to 1.
31
Fixed Issues
CS-59362
To apply this fix, perform the following and then restart the WildFly server to perform the push or
pull operations:
1. Apply the latest patch and start the repository.
32
Fixed Issues
2. Create an S3 store type from IAPI: create type dm_s3_store with supertype dm_store
3. Install $DM_HOME/install/DARsInternal/S3Plugin.dar
4. Create the S3 store object.
The store is configured with the following information:
• java_access: Name of the module (S3 plugin) which the store object represents. The
default value is S3 Plugin for dm_s3_store type objects.
• base_url: S3 storage service URL. Format is http://<X.X.X.X>/<BUCKET> where
— X.X.X.X: URL of S3 store service and the URL format is http://hostname:port.
— BUCKET: Name of the S3 bucket used to push the content. This name is mandatory.
Bucket should be preconfigured in S3 storage service and is accessible using the following
credentials:
— credential_id: Access Key (user id or access key to access the store service).
— credential_key: Password for accessing the store. DFC encrypts or decrypts this
password before storing and passing it on to the plugin.
Once it is configured, the store is accessible as any other Documentum Content Server store.
For more information on Amazon S3, refer to the Documentum Server 16.4 Administration and
Configuration Guide.
CS-59366
33
Fixed Issues
CS-58421
34
Fixed Issues
Issue ID Description
CS-55886 DM_SESSION_E_RPC_ERROR error occurs and
Assertion fails in repository and JMS logs.
CS-54046 Repository crashes with the "Exception
00000000C0000005 (ACCESS_VIOLATION)
occurred at 0000000076E50E91" exception.
35
Fixed Issues
36
Fixed Issues
37
Fixed Issues
Issue ID Description
CS-56687 Issues with relation of dm_user.user_state and
workflow_disabled attributes.
CS-55790 DQL to SQL translation causing
DM_QUERY_E_CURSOR_ERROR error.
CS-56968
In Postgres, you must manually change the datatype of first_use and latest_use columns to timestamp
without time zone in the dm_usage_log table. You must connect to postgres DB and run the following
SQL queries:
alter table dm_usage_log alter column first_use type timestamp without
time zone
alter table dm_usage_log alter column latest_use type timestamp without
time zone
38
Fixed Issues
Issue ID Description
CS-56356 Docbase configuration will fail with PostgreSQL
ODBC drivers 09.06.
CS-51037 Parallel Processing in dmclean : Performance
Improvement for large objects. Additional
Information for Fixed Issues in Patch 03, page 39
contains more information.
CS-51037
You can configure the dm_DMClean job with the following additional parameters:
• batch_size: Configure to enable batch_size option. The default value is 2000.
• DM_USE_PARALLEL_CLEAN_TEMP_TBL: This is a dm_docbase_config object argument. If you
enable this argument, by using the following command, it uses a temp table to fetch orphan object
instead of original content object table. This prevents full table scan.
reterive,c,dm_docbase_config
append,c,l,r_module_name
DM_USE_PARALLEL_CLEAN_TEMP_TBL
append,c,l,r_module_mode
1
Save,c,l
After you run the commands, you must restart the docbase.
batch_size - if enable content parallel option, each iteration fetch batch_size objects to clean.
DM_USE_PARALLEL_CLEAN_TEMP_TBL - environmental variable. if enable this arguments, it
uses temp table to fetch orphan object instead of original table(dmr_content_s). it helps avoid full
table scan issue.
39
Fixed Issues
40
Chapter 7
Known Issues
This section identifies issues and limitations that might affect your use of the product after you
apply the patch.
Issue ID Description
CS-120271 Patch does not work if you rename or remove the WildFly 9.0.1 folder
after upgrading to WildFly 11. This is a design limitation.
41
Known Issues
Issue ID Description
CS-56179 Setting HA_SETUP_ENABLED is causing a workflow to have Content
Server affinity for its whole activities, whatever they are sequential or
parallel. If a Content Server crash, all associated workflows are stuck
or paused state.
Workaround:
1. Install Microsoft SQL Server 2014 ODBC database driver (client) on
the machine that is used to install Content Sever. This driver is used
to create an ODBC data source with the SQL Server 2016 database.
42