Академический Документы
Профессиональный Документы
Культура Документы
Table of Contents
Preface
Chapter 1
Chapter 2
Chapter 3
...........................................................................................................................
8
8
11
11
13
17
17
17
17
18
18
18
19
19
19
19
19
Chapter 4
Chapter 5
7
7
11
11
17
......................................................... 21
................................................................... 27
Table of Contents
List of Tables
Table 41.
24
Preface
Purpose of the Manual
This manual contains information and instructions you need to upgrade Documentum
Content Server on any platform from version 5.2.5 or 5.2.5 SP1 to version 5.2.5 SP2. It
describes requirements that must be met before you upgrade the server. It also provides
step-by-step instructions for upgrading.
Intended Audience
This manual is intended for the person upgrading Content Server from version 5.2.5 or
5.2.5 SP1 to 5.2.5 SP2. Typically, a system administrator upgrades the software.
Revision History
The following revisions have been made to this document:
Revision History
Date
Description
July 2004
First published
Related Documentation
You can find additional information about Content Server in the following manuals:
Preface
Content Server API Reference Manual contains reference information on server API
methods
These manuals are available on the Documentum download site or the product
distribution CD as PDF files.
Conventions
This manual uses the following conventions:
Typographic Conventions
Convention
Description
Represents a menu.
italics
typewriter
[] square brackets
{} curly braces
Chapter 1
Planning for Installation
About Installation
Content Server 5.2.5 Service Pack 2 (SP2) is an incremental maintenance release of
Content Server 5.2.5. SP2 can be installed only to an existing 5.2.5 or 5.2.5 SP1 server
installation. You cannot create a new server software installation from the SP2 software
distribution package.
After you install SP2, you can continue to create new Docbases and DocBrokers by
running the Server Configuration Program. Use the instructions for creating new
Docbases and DocBrokers in the Content Server Installation Guide for release 5.2.5.
You cannot revert to Content Server 5.2.5 or 5.2.5 SP1 after Service Pack 2 is installed
except by destroying the Docbases and DocBrokers and restoring from a full Docbase
backup. The backup must include the database tables for the Docbase and Content
Server host file system, including the file storage areas.
Effects of Installation
Applying SP2 to an existing 5.2.5 or 5.2.5 SP1 Docbase:
Upgrades the DocBrokers and Docbases on the Content Server host from version
5.2.5 or 5.2.5 SP1 to version 5.2.5 SP2
Writes a log file entry to username.ServerSPInstaller.log for every file copied and
every file backed up and replaced
2.
3.
2.
3.
2.
Configuration Decisions
If Content Services for EMC Centera and Trusted Content Services were not enabled
when Content Server 5.2.5 was installed, you can optionally enable them when you
configure the Docbase after installing Service Pack 2.
Content Server 5.2.5 SP2 introduces a new feature, Content Storage Services (CSS),
which requires purchasing a Content Storage Services license. CSS provides tools for
determining content storage for new documents automatically by object type, format,
and other parameters, using assignment policies. Storage for existing documents can be
determined using migration policies. CSS is enabled during Docbase configuration.
Making Backups
The only way to roll back from SP2 to an earlier installation of Content Server 5.2.5 is by
restoring from a backup of the earlier Docbase. Ensure that you create a full Docbase
backup before you install SP2. The backup must include the database tables for the
Docbase and Content Server host file system, including the file storage areas.
Upgrading DocBrokers
If you are upgrading a server installation to SP2, you must upgrade any DocBrokers
in that installation.
You are not required to upgrade DocBrokers on remote hosts.
10
Chapter 2
Upgrading Content Server
1.
2.
11
3.
On UNIX, disable jobs in all Docbases in the installation that you are upgrading.
On UNIX, run the dm_shutdown_Docbase script, where Docbase is the name of the
Docbase to be stopped, then stop each DocBroker using the dm_stop_docbroker
utility. (For instructions, refer to Chapter 7, The DocBroker, in the Content
Server Administrators Guide.)
Shut down all Docbases and DocBrokers in the installation that you are
upgrading.
4.
If you have Apache Tomcat or any other application server running as the Java
method server, shut it down.
To shut down Tomcat on Windows, stop the service called Documentum Java
Method Server.
5.
6.
7.
Navigate to the server version corresponding to your operating system and database.
8.
9.
On UNIX, type
% ContentServerSP_operatingsystem.bin
12
and press Enter, where operatingsystem is the operating system on which you
are installing.
A Welcome dialog box is displayed.
12. Click Next
The installation program collects information about the host and the Documentum
installation. The installation program indicates that an earlier version of the server
exists on the host and asks if you want to upgrade.
13. Click Yes.
The Documentum Foundation Classes Optional Features dialog box is displayed.
14. To install the DFC developer documentation, check the checkbox.
15. On Windows, optionally check the checkbox to install the Primary Interop Assembly
Check the Primary Interop Assembly Installer checkbox to request installation of a
Microsoft installer package (.msi file) for the DFC primary interop assembly (PIA),
or leave the box unchecked if you do not wish to have the package installed. The
installer places the installer package for the DFC PIA into the setup subdirectory of
the program root.
16. Click Next.
An informational dialog box is displayed with information about SP2 and
instructions to stop Docbases, DocBrokers, and the Java method server.
17. Click Ok.
A dialog box is displayed, listing the products and support components to be
installed.
18. Click Next.
DFC is upgraded and the new server software is installed.
19. Choose when to configure the server.
To configure the server immediately, choose Configure server now and click
Next.
To configure the server at another time, choose Configure server later and click
Next.
13
1.
If the setup process on Windows does not continue automatically, follow these steps:
a.
b.
c.
d.
Click Next.
3.
4.
If you did not enable Trusted Content Services during installation, optionally choose
to enable TCS, type in the license key, and click Next.
5.
If you did not enable Content Services for EMC Centera during installation,
optionally choose to enable the feature, type in the license key, and click Next.
6.
7.
8.
a.
b.
c.
Click Next.
The DocBroker is upgraded.
d.
e.
f.
9.
a.
b.
c.
d.
14
e.
f.
10. Choose Apply Service Pack 2 to existing Docbase, select the Docbase, and click
Next.
A dialog box asks if you are sure you want to apply the service pack.
11. Click Yes.
12. Choose whether to accept or modify the Docbase configuration scripts.
In general, you do not need to edit these scripts.
To edit a script, select it and click Edit Script. After you edit and save the
scripts, click Next.
To configure additional Docbases, check the checkbox and click Next, then skip
back to Step 10.
15
16
Chapter 3
Postinstallation Tasks
This chapter describes any tasks that must be done after the product is installed but before it can
be used.
This chapter contains the following major topics:
WDK Applications
If you are running any WDK applications against a Docbase that has been upgraded to
5.2.5 SP2, restart the application server after the Docbase upgrade.
17
Postinstallation Tasks
where DocbaseName is the name of the Docbase you are upgrading, UserName is the user
name of a Superuser, and Password is the Superusers password.
where DocbaseName is the name of the Docbase you are upgrading. Ensure that you
pass in "" as the third argument.
where DocbaseName is the name of the Docbase you are upgrading, UserName is the
user name of a Superuser, Password is the Superusers password, $DM_HOME is
$DOCUMENTUM/product/version_no, and OSName is Windows, Solaris, HPUX, or
AIX.
Templates Script
The templates.ebs script, located in $DM_HOME/install/admin, creates dm_document
objects in order to enable creation of new objects with Documentum Desktop. Certain
applications require default template files when opened. The syntax is:
dmbasic -f templates.ebs -P DocbaseName UserName Password
$Documentum $DM_HOME -e Install
18
Postinstallation Tasks
Install
19
Postinstallation Tasks
where DocbaseName is the name of the Docbase you are upgrading, UserName is the user
name of a Superuser, and Password is the Superusers password.
20
Chapter 4
Setting the i_retain_until Attribute
Release 5.2.5 SP2 introduces a new attribute for the dm_sysobject type called
i_retain_until. This attribute records the most restrictive retention date for objects whose
content is stored in content-addressed storage with a retention date. The most restrictive
date is the retention date farthest in the future, and it may be specified for a primary
content file or a rendition.
The attribute value is displayed by Documentum Webtop, so users can view an objects
retention date. Documentum Administrator displays the attribute value also, and users
with appropriate privileges can change its value through Documentum Administrator.
Upgrading Content Server to 5.2.5 SP2 adds this attribute to the dm_sysobject type
definition and to all SysObjects in the Docbase. However, upgrading does not set the
attribute. After you upgrade, if a Docbase is licensed for Content Services for EMC
Centera and its storage areas include content-addressed stores using retention dates,
you must execute a new administration method, UPDATE_RETAIN_UNTIL_DATE.
This sets the attribute for those objects whose content files have retention dates. This
chapter contains the reference information for executing this method. You must have
Superuser privileges to execute the method.
During normal user operations, this attribute is set by:
This attribute is only set if the executing Content Server or client DMCL is at the
5.2.5 SP2 level. If you run pre-5.2.5 SP2 Documentum clients, specifically Webtop,
against a 5.2.5 SP2 server, the attribute is not updated when users modify content
in content-addressed storage areas. When you do upgrade the client, executing
UPDATE_RETAIN_UNTIL_DATE once again, after the upgrade, is recommended, to
update the i_retain_until attribute for objects that may have been modified using the
pre-5.2.5 clients.
Observe the following guidelines for executing UPDATE_RETAIN_UNTIL_DATE:
If any affected object is checked out while the method executes, subsequent attempts
to check in the object fail due to a version mismatch error. Consequently, it is
21
strongly recommended that you execute the method in a quiet Docbase and that all
objects are checked in.
Executing this method does not reset the r_modify_date on the objects. However, it
updates the i_vstamp. Because of this, if objects are part of a replication job, they are
re-replicated.
22
UPDATE_RETAIN_UNTIL_DATE
UPDATE_RETAIN_UNTIL_DATE
Purpose
Syntax
To update the attribute for a single SysObject:
EXECUTE update_retain_until_date
FOR sysobject_id
dmAPIGet("apply,session,sysobject_id,UPDATE_RETAIN_UNTIL_DATE")
To update the attribute for all objects that satisfy a DQL query:
EXECUTE update_retain_until_date
WHERE_CLAUSE=qualification[,BATCH_SIZE=integer]
dmAPIGet("apply,session,NULL,UPDATE_RETAIN_UNTIL_DATE,
WHERE_CLAUSE,S,qualification[,BATCH_SIZE,I,integer]")
23
UPDATE_RETAIN_UNTIL_DATE
Arguments
Table 41. UPDATE_RETAIN_UNTIL_DATE Arguments
Argument
Datatype
Value
Description
WHERE_CLAUSE
qualification
BATCH_SIZE
integer
Return Value
The method returns a collection with one query result object. That object has one
attribute, named result, that records the number of objects modified by the method.
Permissions
You must have Superuser privileges to execute this method.
24
UPDATE_RETAIN_UNTIL_DATE
General Notes
This method affects only objects that have one or more primary content files or renditions
stored in a content-addressed storage area with a retention date. The method sets the
i_retain_until attribute of the object to the most restrictive of the retention dates specified
for the primary and rendition content files that are stored in the content-addressed
storage areas.
The most restrictive date is defined as the date that is farthest in the future from the
current date.
Caution: Executing this method updates the i_vstamp attribute of affected objects.
Because the method updates i_vstamp, if an affected object is checked out when the
method executes, checking in the object will fail with a version mismatch error. It is
strongly recommended that you execute this method when there is little or no activity in
the Docbase and that all objects that may be affected are checked in before executing the
method.
The value for the i_retain_until attribute is computed based on information retrieved
from the content-addressed storage system. Because of this, there may be a small
difference between the retention date specified when the object was created and the
date for the i_retain_until attribute that is set by the UPDATE_RETAIN_UNTIL_DATE
method. The retention period in seconds is retrieved from the storage system and is
added to the r_creation_date attribute of the object to compute the retention date.
The method does not reset the r_modify_date attribute of the affected objects.
The method logs messages in the server log.
Examples
The following examples update the attribute for the document identified by
090000013573af2c:
EXECUTE update_retain_until_date
FOR 090000013573af2c
dmAPIGet("apply,c,090000013573af2c,UPDATE_RETAIN_UNTIL_DATE")
25
UPDATE_RETAIN_UNTIL_DATE
WHERE_CLAUSE,S,subject=email_msg,BATCH_SIZE,I,200")
26
Chapter 5
Uninstalling Content Server
You cannot uninstall or back out Service Pack 2 except by restoring from a full Docbase backup,
including database tables and the Server host file system.
To delete a Docbase or DocBroker, or to uninstall the Server software, use the instructions in the
Content Server Installation Guide for version 5.2.5.
27