Documente Academic
Documente Profesional
Documente Cultură
Installation Guide
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Table of Contents
Preface
Chapter 1
Chapter 2
.................................................................................................................................
Installing Content Transformation Services
................................................ 11
11
12
14
14
15
15
16
16
17
17
18
18
18
18
21
22
22
23
23
31
.............................................
Uninstalling Content Transformation Services ....................................................
Manual uninstallation ...................................................................................
Backing up and removing old profiles........................................................
Viewing log file of migrated profiles ......................................................
24
25
27
29
32
32
33
33
35
35
35
36
36
37
37
38
39
Table of Contents
39
40
40
41
41
.............................. 43
Verifying Content Transformation Services installation ....................................... 43
Verifying startup of Content Transformation Services service .......................... 43
Chapter 3
Chapter 4
45
Prerequisites ....................................................................................................
45
46
Chapter 5
Chapter 6
Chapter 7
46
47
47
47
48
48
48
49
49
49
50
50
......................... 53
53
56
59
63
63
64
64
64
64
65
66
66
66
66
67
...................................................................... 69
Table of Contents
69
70
Table of Contents
List of Figures
Figure 1.
12
Figure 2.
12
Table of Contents
List of Tables
Table 1.
Table 2.
18
Table 3.
24
14
Table of Contents
Preface
This guide provides step-by-step procedures for installing Documentum Content Transformation
Services. It lists installation prerequisites and provides step-by-step instructions for installing and
uninstalling the Content Transformation Server for your product(s). In addition, this manual includes
a brief overview of Content Transformation Services architecture.
Preface
The EMC Documentum Content Transformation Services Administration Guide describes the functionality
of Content Transformation Services in detail.
Intended audience
This guide is intended for the person who installs and configures Content Transformation Services,
often called the system administrator or system operator.
It is assumed that the system operator has a basic understanding of the Windows operating system.
Revision history
The following changes have been made to this document.
Revision Date
Description
November 2012
Initial publication
10
Chapter 1
Installing Content Transformation
Services
This chapter describes the process of installing Content Transformation Services on a Windows host.
Post-installation tasks, configuration tasks, and troubleshooting information are also provided in
this document.
Installed components, page 11
Pre-installation configuration, page 14
Installing Content Transformation Services, page 21
Post-installation tasks, page 31
Content Transformation Services allows for a high level of scalability. Content Transformation
Services runs under the Windows Service on the Content Transformation Services host.
Each Content Transformation Services instance can be configured for multiple repositories. If you
have one installation of Content Transformation Services on a host, the same installation can be
configured against different repositories.
Installed components
This section describes the architecture of the installed Content Transformation Services.
Content Transformation Services integrates with third-party plug-ins to enable transformation of
objects into renditions.
11
Figure 1. Typical Content Transformation Services installation for PDF and HTML transformation
Content Transformation Services integrates with streaming servers so that you can view streamed
media from the repository without waiting for the file to download. Thumbnail servers enable
automatic transformation of files into thumbnails or storyboards after they are imported into the
repository.
Figure 2. Typical Content Transformation Services installation for audio, video, and image transformation
12
13
Pre-installation configuration
Ensure that the following requirements are met before you install Content Transformation Services:
Software prerequisites, page 14
Selecting the server host, page 15
Documentum Foundation Classes, page 15
Downloading installers, page 16
Setting up a global registry, page 16
Verifying the connection broker, page 17
Setting the locale of the repository and host, page 18
Installing Microsoft fonts, page 18
Required installation information, page 18
Software prerequisites
This section provides information about the software that is required or optional for Content
Transformation Services.
The following software must be installed, configured, and running properly on your network before
you install Content Transformation Services:
Documentum Content Server
Before installing Content Transformation Services, you must install several applications and other
components on the server host (or another machine, where applicable). Table 1, page 14 provides
details about the software that must be installed, configured, and running properly on the host (or
another machine, whichever applicable) before you install Content Transformation Services.
Table 1. Transformation Services
Required/
Optional
Notes
Documentum Composer/DAR
Installer
Required
Required
Documentum Administrator
Optional
14
Required/
Optional
Notes
Optional
Optional
Note: Ensure that all applications are installed in their default location. Content Transformation
Services refers to each applications default installation directory while launching an application.
Some applications provide you with the choice of installing them with either minimal or full options.
Applications installed with minimal options may not run correctly with Content Transformation
Services.
15
Document Foundation Classes must be installed on the Content Transformation Services host, and is
included with each installer. During installation, Content Transformation Services installer checks for
an existing Document Foundation Classes on the host. The following scenarios are possible:
If Document Foundation Classes does not exist on the host, the installer installs the correct version.
If an earlier version of Document Foundation Classes exists on the host, it is replaced by the
version included with the installer. Refer to the EMC Documentum System Upgrade and Migration
Guide for more information on migration issues.
Any applications that were dependent upon an earlier version of Document Foundation Classes
will have to be upgraded as well. For more information on Document Foundation Classes and its
effect on other applications, refer to your specific Documentum application documentation.
If a version of Document Foundation Classes exists and it is newer than that which is included
with the installer, it will be refreshed.
Downloading installers
Before beginning the installation process, it is best to have the installer ready and available
on your Content Transformation Services host. The EMC Software Download Center
https://emc.subscribenet.com provides a complete listing of products is available for download. The
download files for Content Transformation Services is as follows:
Content Transformation Services Installer Zip file (cts_7.0.0000.xxxx.zip)
The zipped file contains the executable installer file (ctsWinSuiteSetup.exe), silent installer
batch files, and configuration files.
Unzip the zipped files into a temporary folder before you proceed with the installation.
16
2.
During repository configuration, you are prompted to provide the user login name and
password for the global registry user. By default, the global registry user has the user name
of dm_bof_registry.
The global registry users account is used by Document Foundation Classes clients to connect
to the repository to access required service-based objects or network locations stored in the
global registry. The global registry user has Read access to objects in the /System/Modules and
/System/NetworkLocations only, and no other objects.
3.
When you install Document Foundation Classes on client machines, provide those Document
Foundation Classes installations with the global user login credentials.
This applies to Desktop installations on end-user computers, to Web Development Kit-based
clients such as Webtop on application server host, and to the Document Foundation Classes
instances on Content Server and remote Content Server hosts.
4.
Ensure that the global registry repository projects to connection brokers known to the Document
Foundation Classes instances that must access the global registry. Identifying a Connection
Broker in dfc.properties, page 17 provides instructions.
Search for the dfc.properties file on your Content Transformation Services host server. The
file is usually located in the Windows (C:\Documentum\config) folder.
2.
3.
Find the line indicating the Connection Broker. Ensure that the specified Connection Broker is the
one that contacts the repository. Change it if necessary.
4.
17
Installation information
Description
Your value
18
Installation information
Description
Content Transformation
Services server installation
directory
Your value
19
Installation information
Description
Your value
Content Transformation
Services notifies the user of
the results of processing.
For example, if Content
Transformation Server fails to
process a particular item, it
queues an event to the Inbox
of the Content Transformation
Server system operator user
(sysOpUser).
Content Transformation
Services Admin Port
Domain name
Global registry
Different Document
Foundation Classes
installations can use different
global registries where required
service-based objects or
network locations are stored. A
single Document Foundation
Classes installation can have
only one global registry. You
will be prompted during
installation for the primary
registry.
dm_bof_registry
20
Installation information
Description
Your value
dm_bof_registry. During
repository configuration,
provide the user login name
and password for the global
registry user. The global
registry user should be
someone other than the
administrator.
2.
3.
4.
After installing the Content Transformation Services server, you can verify that your installation
is running correctly. Verifying Content Transformation Services installation, page 43 explains
this procedure.
21
2.
3.
4.
5.
For each folder, select Delete This folder and All Subfolders and Objects and Delete All
Versions.
6.
7.
8.
22
Extract the headless Composer Zip file to a directory of your choice on your local machine. The
directory name must not contain any spaces.
2.
3.
Add the Document Foundation Classes and connection broker information, similar to the
following:
dfc.docbroker.host[0]=[DocBroker IP address or host name]
4.
Download the DAR Installer zip file from the same place that you downloaded Composer. You
can find the DAR Installer Plugin by going to https://emc.subscribenet.com/control/dctm/search
and searching for "Composer to reach the Documentum Composer download site.
2.
Unzip the DAR Installer zip file to the root of your Composer or headless Composer installation
directory.
3.
Run dardeployer.exe, which is located in the Composer root directory, to start the DAR
Installer Plugin.
23
4.
5.
In the Connection Broker Details section, specify values for Connection Broker Host and
Connection Broker Port and click Connect.
6.
In the Repository Details section, specify values for the fields and click Install to install the
DAR file to the repository.
Refer to the Description of DAR Installer Fields table to help guide you through the DAR file
install process.
7.
You can view the log for the DAR installation by selecting the log file from the Log File drop down
menu and clicking Open.
Table 3. Description of DAR Installer Fields (Content Transformation Services DAR)
Parameter
Required
Description
DAR
Yes
The absolute file path to the .dar file that you want to install. The
file path cannot contain any I18N characters or the installation
will fail.
Input File
No
Local Folder
No
Log File
No
The file to save the log to. If this is not specified, the file defaults
to <DAR>.log
Connection
Broker Host
Yes
Connection
Broker Port
Repository
Yes
Yes
The name of the repository that you want to install the DAR file
to. Click on the Connect button after entering the Docbroker host
and port to retrieve the available repositories.
User Name
Yes
Password
Yes
Domain
No
24
name_of_distributed_store represents the name of the distributed storage area you created.
2.
3.
Navigate to the folder containing the unzipped Content Transformation Server product
installation files. You must have stored the unzipped files in a temporary folder according to
Downloading installers, page 16.
4.
Double click the ctsWinSuiteSetup.exe file to install the 7.0 version of Content
Transformation Services.
The installer splash screen is displayed, followed by the Welcome screen, which lists the
components being installed.
5.
Click Next.
The license agreement terms are displayed.
6.
Select I accept the terms of the license agreement, and then click Next.
If Document Foundation Classes is already installed on the host server, the installer checks the
version of Document Foundation Classes. If an earlier version of Document Foundation Classes
is detected, it is replaced.
7.
The DFC Runtime Environment Optional Features screen appears. To install the Developer
Documentation select Developer Documentation, and click Next.
The Documentum DFC Runtime Environment Directory for Documentum Software screen
appears.
8.
Change the destination folder for Document Foundation Classes (the default is C:\Program
Files\Documentum\), if required, and then click Next. To accept the default, click Next.
Caution: Document Foundation Classes must be installed in the same location as Content
Transformation Services.
Note: If the correct version of the Document Foundation Classes exists on your system, this
screen does not appear; go to Step 11.
25
9.
Enter the User Directory for DFC Runtime Environment. This is where exported documents,
checked out documents, and Document Foundation Classes log files are stored. The default
directory is C:\Documentum.
If required, change the user directory for Document Foundation Classes, and then click Next. To
accept the default directory, click Next.
Note: If the correct version of the Document Foundation Classes exists on your system, this
screen does not appear; go to Step 11.
10. Enter a Connection Broker host name (or IP address) and port number.
Type the name of the Connection Broker host name in the Primary Connection Broker Host
Name field and, optionally, type the port number in the Port Number field, and click Next.
Note: If the correct version of the Document Foundation Classes exists on your system, this
screen does not appear; go to Step 11.
11. Identify the Content Transformation Services installation directory (for core components that
Content Transformation Services use). The Installer creates a directory named CTS within the
chosen directory.
It is recommended to accept the default directory (for example, C:\Program
Files\Documentum\CTS), where other Documentum products are installed.
To accept the default directory, click Next.
To choose another directory, click Browse, navigate to the directory, and click Next.
12. Identify the host name of the host machine. This may be detected automatically, if you are
installing directly from the host. Otherwise, enter the network host name.
Click Next.
13. Identify the port number to which the Content Transformation Services Administration Agent
will be configured. This port is used in conjunction with Documentum Administrator to
communicate with Content Transformation Services hosts. The default port number is 9095.
Enter a port number and click Next.
14. Identify the port number to which Content Transformation Services WebServices will be
configured. The default port number is 9096.
Click Next.
Note: The installer automatically stops the Content Transformation Service if it is already
present on the host.
15. Enter the Admin user name and password; if you are installing for a domain user, use the format
<domain>\<username>.
Caution: It is recommended that you run the Content Transformation Services as a user
other than your actual server admin.
Click Next.
16. The Installation Summary screen appears, listing the applications that will be installed.
26
Note: If the correct version of Document Foundation Classes is already installed, the summary
screen will show that Document Foundation Classes is being refreshed.
If you are satisfied with the installation confirmation, click Next.
To change a component of the installation, click Back to navigate back through the Installer
and change the install information.
17. The installation proceeds.
If a message appears advising you that the _jvm directory already exists, click Yes to overwrite
the directory.
18. The installer now migrates all old profiles automatically. A dialog box appears confirming
the following information:
Creation of a pre-migration report of all profiles before they are upgraded.
Confirmation of the beginning of the profile migration process.
Reminder to backup all profiles first, before continuing.
If you have backed up your old profiles, click Next. The installation proceeds.
19. The DFC Global Registry designation screen appears. Identify the global registry repository.
Select Designate the global registry repository to use. Enter the repository name and password.
Select Test Connect, if desired. Click Next.
20. Enter the default global registry user name (dm_bof_registry) and password. This should be
someone other than the administrator. Click Next.
21. A message notifies you that the Content Transformation Server was installed successfully. Click
Finish.
The installation wizard closes.
Note: If you selected to restart your Microsoft Windows system immediately, the system will
restart.
Navigate to the Content Transformation Services Configurator located under Start > Programs >
Documentum > CTS Configuration Utility and click the CTS Configuration Utility.
27
Click Next.
The license agreement terms are displayed.
3.
Select I accept the terms of the license agreement, and then click Next.
4.
Select Add a Content Transformation Services instance to a docbase, and click Next.
The Configurator stops the Content Transformation Services service.
5.
The Configurator detects the name of the Content Transformation Server host. Please correct the
host name if it is invalid or append the domain to create a Fully Qualified Domain Name
6.
Click Next.
The Enter repository name and user info screen appears.
A list of the repositories served by the Connection Broker appears. For instructions on selecting a
Connection Broker, see Identifying a Connection Broker in dfc.properties, page 17.
7.
Enter the SuperUser name that Content Transformation Server will use to access the
repository. (Do not use dm_mediaserver.)
Note: In a domain-required repository, you must configure the product with a registered
domain user.
Enter the domain name, if applicable. This is an optional field; if you are installing from a
local machine, this can be left blank.
f.
Enter the name of the repository user who will receive notifications from Content
Transformation Server, otherwise known as the system operator. (Do not use
dm_mediaserver.)
Note: If you are unsure of which users to specify, refer to Required installation information,
page 18 for details regarding values for these fields.
g. If you are not configuring multiple domains, skip this step and proceed to Step 8.
1.
Select the Add Additional Domain Users check box, if you are setting up to support
requests from additional domains. If you have multiple domains in your environment
and you have users in different domains that will be transforming content, select
this option. The installer will create an Admin user for each domain to support
transformations by users of each domain.
2.
Enter credentials for a new domain and its SuperUser in the required fields.
3.
h. For performance metric reports to be generated, select Set as Performance Log Repository.
8.
28
Click Next.
If you cannot continue, check with the repository administrator to verify that the users exist
and that you entered the correct password.
9.
The User Authentication screen appears. Enter the system administrator name and password;
if you are installing as a domain user, use the format <domain>/<username> in the system
administrator name field. Click Next.
The registry updates.
10. If the repository you have chosen is in a distributed environment, a screen will appear with a
list of Content Servers configured for the repository you have chosen to configure with Content
Transformation Server.
Select a Content Server from the list and select Process local content only.
11. If Content Transformation Services is configured to a repository which has BOCS enabled, an
additional wizard screen displays asking you to select a Network location ID to use from the list
of network locations which the repository supports:
Select the Network Location which has BOCS configured.
Enable the following information fields:
Allow BOCS Transfer
Prefer ACS Transfer
Allow Surrogate Transfer
12. The Configurator now migrates all old profiles automatically, if applicable. A dialog box appears
confirming the following information:
Creation of a pre-migration report of all profiles before they are upgraded.
Confirmation of the beginning of the profile migration process.
Reminder to backup all profiles first before continuing.
If you have backed up your old profiles, select Next. The installation proceeds.
13. A message appears that states "A pre-migration report has been generated and is available at
%CTS_HOME%\migration\log. Click Next. The migration process begins.
Note: If you are not upgrading from a previous version, proceed to the next step.
14. A dialog box indicates the success of the Content Transformation Server configuration.
If you are prompted to restart the host, do so now.
Click Finish. The Configurator closes.
29
2.
3.
Navigate to the folder containing the unzipped Content Transformation Server product
installation files. Downloading installers, page 16 provides information about where the files
should be located.
4.
5.
30
DOCBASE_USER=<DOCBASE_USER>
NOT_ENCRYPTED_PASSWORD=<DOCBASE_PWD>
DOMAIN=
DOCBASE_SUPERUSER=<DOCBASE_SUPERUSER>
#CTS machine user details to create CTS Services.
#If user logged into domain, SYS_ADMIN_NAME should contain <Domain>\<Username>
SYS_ADMIN_NAME=<ADMIN_NAME>
SYS_ADMIN_PASS=<ADMIN_PASS>
#BOCS related settings
# To configure BOCS change SKIP_BOCS=NO and set all the required parameters.
SKIP_BOCS=Yes
#BOCS_SELECTED=<dm_network_location_map object_name>
#allowBocsTransfer=<true | false>
#preferAcsTransfer=<true | false>
#allowSurrogateTransfer=<true | false>
#Distributed enviromnent settings.
#SERVER_CONFIG_NAME=<dm_server_config object_name>
#PROCESS_LOCAL_CONTENT_ONLY=<YES | NO>
[MTS]
CONFIGURATOR_DIR=C:\PROGRAM FILES\DOCUMENTUM\CTS\server_install
INSTALL_TYPE=add
6.
7.
8.
Post-installation tasks
After installing Content Transformation Services, perform the following configurations, if required:
Enabling a Document Foundation Classes installation to access a global registry , page 32
describes the process to configure the Document Foundation Classes installation to access a
global registry, if you did not select a global registry during the installation, or if the password
for the global registry user has changed, or if you are updating the dfc.properties file with a
different global registry than initially configured.
Configuring Content Transformation Server for another repository, page 32 describes the process
to add more than one Content Transformation Server configurations to your system.
31
Enhancing memory availability for Content Transformation Services, page 33 describes the
process to increase the memory availability of Content Transformation Services.
Configuring separate Content Transformation Services instances to handle real-time and
asynchronous requests, page 33 describes the process to configure Content Transformation
Services to handle real-time and asynchronous requests
2.
From a command prompt, execute the following command to generate the encrypted form of
the global registry users password:
java -cp dfc.jar com.documentum.fc.tools.RegistryPasswordUtils password_of_user
where password_of_user is the global registry users clear-text password. In step 4 below, you will
need to enter the encrypted form of this password in the dfc.properties file.
Note: Before executing this command, either ensure that the classpath contains dfc.jar or
execute the command from a location where dfc.jar is present (for example, C:\PROGRA~1
\Documentum\Shared).
3.
4.
32
See Configuring an instance of a Content Transformation Services server, page 27 for the procedure to
configure your product for another repository.
2.
Select Windows > Administrative Tools > Services to access the Windows Services Utility.
3.
4.
5.
Navigate to
[HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\services\DocumentumCTS\Parameters].
Modify the value of AppParameters.
6.
Increase the -Xmx4096m value by adding 1024 to 4096 for every 1 GB extra RAM added. For
example, for 2 GB extra RAM added, add 2048 to 4096. Hence, the new value is -Xmx6144m.
7.
8.
The "CTS_Realtime instance should be tuned to not ping the queue and not pick up any of
the queue items.
a.
33
c.
Use this configuration element to specify a list of semicolon separated Content Transformation
Services instances.
ServerProperty Key="CTS_SkipList" Description="list of cts instances
(semicolon separated) to skip (scalability)" Value="CTS_Async;
<other-cts-instances>"/>
Note: Use the hostname as it appears in cts_instance_info table. To retrieve the hostname,
run the "Select hostname from cts_instance_info DQL.
The EMC Documentum Content Server Administration and Configuration Guide provides details
on the above configuration element "CTS_SkipList.
With these changes, "CTS_Realtime will not pick up any of the queue items and will be dedicated
only for the real-time requests. The "CTS_Async will not receive any of the real-time requests and
will process only the queue items. This approach can be scaled up and applied to configure multiple
Content Transformation Services instances for handling either real-time or asynchronous requests.
34
Chapter 2
Upgrading Content Transformation
Services
Manual uninstallation
The following steps comprise the manual uninstallation process for Content Transformation Services:
1.
2.
3.
4.
35
2.
Back up any customized profiles from the previous version by exporting the contents of the
Media Server folder to a local disk.
3.
Delete the contents of the Media Server folder (including all versions and descendents).
The migration report log shows a complete list of all profiles before they are upgraded:
migration_report_2007_292_1192813563921.txt ->
Report log
36
Navigate to Content Transformation Services Configurator under Start > Programs >
Documentum > CTS Configuration Utility.
Note: If you have an instance of a version prior to this version of Content Transformation
Services, you must navigate to Start > Programs > Documentum > <Content Transformation
Services product> Configuration Utility.
The Content Transformation Services Configurator splash screen is displayed, followed by
the Welcome screen.
2.
Click Next.
The License Agreement Terms are displayed.
3.
4.
Select Remove a Content Transformation Server instance from a docbase and click Next.
5.
Select the repository from which you want to remove the Content Transformation Server.
Enter the SuperUser name, the SuperUser password, and the Domain if any.
6.
Click Next.
7.
Click Next.
If you cannot continue, check with the repository administrator to verify that the user exists
and that you entered the correct password.
8.
Click Finish in the dialog box indicating the success of the Content Transformation Server
removal.
This instance of Content Transformation Server is now removed from the repository.
37
If you have installed a previous version of a Content Transformation Services product, uninstall
the product in the following order:
1.
2.
If you have installed the 7.0 version of Content Transformation Services, you must uninstall the
product in the following order:
1.
2.
On the host machine, select Start > Settings > Control Panel and double-click Add/Remove
Programs.
2.
Perform one of the following steps in the Add or Remove Programs window:
Select <Documentum Content Transformation Services product> if you are uninstalling an
earlier version, and click Change/Remove.
If you are uninstalling this version of Content Transformation Services, select Documentum
Content Transformation Services, and then click Change/Remove.
3.
4.
2.
3.
Click Start > Settings > Control Panel and double-click Add/Remove Programs.
4.
5.
Click Next.
6.
The location from which Content Transformation Services will be removed is displayed. Click
Next.
The Content Transformation Services service stops and Content Transformation Services
Framework is uninstalled.
38
7.
Restart the computer when you are prompted. All files that have been in use are deleted. This is
important if you are reinstalling Content Transformation Services on the host.
8.
Delete the log4j.properties file from the Content Transformation Services installation
folder location.
Silent uninstallation
If you want to run the silent unconfiguration and uninstallation utilities to remove Content
Transformation Services from the server, perform the following steps:
1.
2.
Removing Content Transformation Services repository configuration settings in the silent mode,
page 39
3.
Note: This procedure is applicable only to Content Transformation Services, version 6.7 and later.
2.
3.
39
[MTS]
CONFIGURATOR_DIR=C:\PROGRAM FILES\DOCUMENTUM\CTS\server_install
INSTALL_TYPE=remove
4.
Run run_CTS_silent_configurator.bat.
2.
3.
2.
3.
Note: If you are uninstalling a Content Transformation Services product version prior to the 7.0
version, execute the following command to uninstall Content Transformation Services:
start
The control is not returned to user until the command is fully executed.
Note: If the uninstallation fails, the contents of the mts folder are not deleted and uninstallation
log files appear.
4.
40
2.
3.
The control is not returned to user until the command is fully executed.
Note: If the uninstallation fails, the contents of the cts folder are not deleted and uninstallation
log files appear.
4.
2.
3.
If the LaunchUninstaller.bat file is not available, then use the uninstall.exe file.
Note: If the uninstallation fails, the contents of the dfc folder are not deleted and uninstallation
log files appear.
4.
41
42
Chapter 3
Verifying Content Transformation
Services Installation
2.
Select Windows > Administrative Tools > Services to access the Windows Services utility.
43
3.
44
Chapter 4
Integrating a Streaming Server with
Content Transformation Services
This chapter describes how to integrate a Streaming Server with Content Transformation Services and
Content Server. It also provides an example of how to test the Streaming Server integration.
Supported streaming file format families depend upon the Streaming Server(s) that you integrate
with Content Transformation Services.
The following topics and tasks are included in this chapter:
Prerequisites, page 45
Setting up a Streaming Server, page 46
Setting up streaming storage areas, page 46
Setting default_storage for the format objects, page 47
Ensuring Streaming Server access to storage areas, page 49
Creating mount points or VirtualDirectory, page 49
Setting the storage areas base_url attribute, page 49
Testing the Streaming Server, page 50
Prerequisites
Content Transformation Services does not include a Streaming Server. Streaming Server requirements
must be followed as per the documentation for those products. Content Transformation Services
is agnostic regarding streaming video servers and does not explicitly certify specific products or
versions. Streaming Servers must be purchased from their vendors.
Before integrating one or more Streaming Servers, they should be installed on their own host, where
possible. The Streaming Server should not be installed on the Content Server host. In many cases, the
intensive operations of the Streaming Server may degrade the performance of the Content Server.
There may be some exceptions to this, such as Windows Media Server. Please see your streaming
server product documentation for further detail.
45
Create a second dm_filestore object to store Windows Media streaming formats, if applicable.
Setting up streaming storage areas, page 46 provides detailed information.
2.
Set the default_storage attribute in the streaming format objects to the streaming storage area, as
described in Setting default_storage for the format objects, page 47.
3.
Ensure that the Streaming Server has access to the storage area. Follow the instructions in
Ensuring Streaming Server access to storage areas, page 49.
4.
Create a mount point (or a VirtualDirectory for Adobe Flash Media Server) on the Streaming
Server for the storage area, as described in Creating mount points or VirtualDirectory, page 49.
5.
Set the base_url attribute for the storage area. Setting the storage areas base_url attribute, page
49 provides detailed information.
6.
7.
If using Windows Media Server, it should be initialized at least once prior to using with Content
Transformation Services.
See the instructions provided in the EMC Documentum Content Server Administration and
Configuration Guide to create a dm_location object. Using DQL statements, your setup should
appear similar to the following:
create dm_location object
set object_name = streaming_storage_02',
set path_type = directory',
set file_system_path =
C:\DOCUMENTUM\data\<repository>\streaming_storage_02',
set mount_point_name = '
go
46
2.
See the instructions provided in the EMC Documentum Content Server Administration and
Configuration Guide to create a dm_filestore object. Ensure that you set the media_type to 2. Using
DQL statements, your setup should appear similar to the following:
create dm_filestore object
set name = streaming_store_02',
set root = streaming_storage_02',
set is_public = true,
set require_ticket = false
set media_type = 2
go
For example, the following DQL statement will find the name of the mov extension:
select * from dm_format where dos_extension = 'mov'
The result of the mov query will be one record, where quicktime is the proper format name for the
mov extension:
r_object_id
name
description
dos_extension
2701e306800001bf
quicktime
QuickTime Movie
mov
47
For example, if the Windows Media file formats are to be stored in streaming_store_01, the statement
should appear as follows:
UPDATE dm_format OBJECTS
SET default_storage=(SELECT r_object_id FROM dm_filestore
WHERE name ='streaming_store_01')
WHERE name in (wmv', wma', wmx', wax', asf')
For example, if the Real Helix server formats are to be stored in streaming_store_02:
UPDATE dm_format OBJECTS
SET default_storage=(SELECT r_object_id FROM dm_filestore
WHERE name ='streaming_store_02')
WHERE name in (ra', ram', rm', rmm', rnx', rv', quicktime')
Darwin formats
Use the following DQL statement to update the formats recognized by the Real Media storage area:
UPDATE dm_format OBJECTS
SET default_storage=(SELECT r_object_id FROM dm_filestore
WHERE name ='<storage_area_name>')
WHERE name in (<format_name>', <format_name>')
Flash formats
Use the following DQL statement to update the formats recognized by the Adobe Flash Media
Server storage area:
UPDATE dm_format OBJECTS
SET default_storage=(SELECT r_object_id FROM dm_filestore
WHERE name ='<storage_area_name>')
WHERE name in (<format_name>', <format_name>')
48
For Real Helix Universal Server, the base_url is typically similar to:
Real file formats
rtsp://<host_name>:<port>/mountpoint1/
Windows file formats (if you are not using Windows Media Server as well)
49
http://<host_name>:<port>/mountpoint2/
For Darwin:
Use the following DQL statement to set the base_url attribute:
UPDATE dm_filestore object
set base_url='rtsp://<machine name>/'
where name = 'storage_area_name'
50
51
API>
2.
Concatenate the value for base_url and path (for example, rtsp://eng178:554/mountpoint1/
001e9a8b\80\00\00\42.rm) and paste the string into the Real Player.
The video represented by the URL will begin to stream.
52
Chapter 5
Deploying Content Transformation
Services WebServices
2.
Create a server instance according to the tcServer guidelines. For example, the server instance
name is "myserver.
3.
4.
Create a folder with the name "cts_ws at your working directory (Consider C:\Documentum
as your working directory).
a.
53
Open a text editor and create a preferences.xml file with the following content and save it in
the directory %WorkingDir%\cts_ws\config.
6.
This file should contain relevant values for your repository name, domain name (if applicable),
user name, and so on.
<?xml version="1.0" encoding="UTF-8" ?>
<ServiceConfiguration ID="CTS Web Services">
<PropertyList>
<ServerProperty Key="Cache" Description="The Temporary Cache Directory"
Value="C:\Documentum\cts_ws\cache" />
<ServerProperty Key="AllowDirectTransfer" Description="Allow Direct File
Transfer From CTS Server to Client. Set it to false if there is a firewall
restriction" Value="true" />
<ServerProperty Key="CTSWSPingInterval" Description="Interval (in seconds)
used to specify how frequent the LB should ping its CTS instances for heart
rate." Value="180" />
<ServerProperty Key="FailoverRetries" Description="Allow a number of retries
if a request fails while waiting on the HTTP response from CTS" Value="1" />
<ServerProperty Key="InstanceSelector" Description="Specify an implementation
class for instance selection"
Value="com.emc.documentum.cts.lb.workers.DefaultSelector" />
<Repositories>
<AekFilePath>C:\Documentum\cts_ws\config\aek.key</AekFilePath>
<LoginContext DocbaseName="<docbase_name_here>">
<ServerProperty Key="domain" Value="<domain_name_here>" />
<ServerProperty Key="userName" Value="<user_name_here>" />
<ServerProperty Key="passwordFile"
Value="C:\Documentum\cts_ws\config\pfile\mspassword.txt" />
<ServerProperty Key="maxConnectionRetries" Value="10" />
</LoginContext>
</Repositories>
</PropertyList>
</ServiceConfiguration>
7.
Copy the aek.key file from the Content Transformation Services Server machine (located at
C:\Program Files\Documentum\CTS\config) and paste it to C:\Documentum\cts_ws\config
on the Content Transformation Services WebServices/tcServer host.
8.
Copy the mspassword.txt from the Content Transformation Services Server machine
(located at C:\Program Files\Documentum\CTS\docbases\<docbase_name>\config\pfile)
and paste it to C:\Documentum\cts_ws\config\pfile on the Content Transformation Services
WebServices/tcServer host.
9.
10. Copy and paste the exploded transformation folder to the "webapps folder of a tc Server
instance. For example, C:\tc-server-standard-2.6.3\myserver\webapps.
a.
54
dfc.globalregistry.password=YiYQgefRI63JTWDokb7HJQ==
dfc.globalregistry.repository=CSFPI33_GR
dfc.globalregistry.username=dm_bof_registry
dfc.search.ecis.enable=false
dfc.search.ecis.host=
dfc.search.ecis.port=
dfc.tokenstorage.dir=${dfc.data.user_dir}/apptoken
dfc.tokenstorage.enable=false
dfc.docbroker.host[0]=10.31.107.145
dfc.docbroker.port[0]=1489
b. Update the log4j.properties file under WEB-INF\classes to point to the right location
for all log files. Properties which should be modified are given in bold.
log4j.rootCategory=WARN, A1, F1
log4j.category.MUTE=OFF
log4j.additivity.tracing=false
log4j.category.tracing=DEBUG, FILE_TRACE
#---------------------------- CONSOLE ---------------------------106 EMC Documentum Content Transformation Services Version 7.0 Installation Guide
Deploying CTS WebServices
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.threshold=ERROR
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d{ABSOLUTE} %5p [%t] %20c{1} %m%n
#---------------------------- FILE ---------------------------log4j.appender.F1=org.apache.log4j.RollingFileAppender
log4j.appender.F1.File=C:/Documentum/cts_ws/logs/log4j.log
log4j.appender.F1.MaxFileSize=10MB
log4j.appender.F1.layout=org.apache.log4j.PatternLayout
log4j.appender.F1.layout.ConversionPattern=%d{ABSOLUTE} %5p [%t] %20c{1} %m%n
#---------------------------- FILE_TRACE ---------------------------log4j.appender.FILE_TRACE=org.apache.log4j.RollingFileAppender
log4j.appender.FILE_TRACE.File=C:/Documentum/cts_ws/logs/trace.log
log4j.appender.FILE_TRACE.MaxFileSize=100MB
log4j.appender.FILE_TRACE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE_TRACE.layout.ConversionPattern=%d{ABSOLUTE} [%t] %20c{1} %m%n
#---------------------------- CTSWS ---------------------------log4j.category.com.emc.documentum.fs.services.transformation=DEBUG, CTSWSAppender
log4j.category.com.emc.documentum.cts=DEBUG, CTSWSAppender
log4j.appender.CTSWSAppender=org.apache.log4j.DailyRollingFileAppender
log4j.appender.CTSWSAppender.File=C:/Documentum/cts_ws/logs/CTSWS_log.txt
log4j.appender.CTSWSAppender.Append=true
log4j.appender.CTSWSAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.CTSWSAppender.layout.ConversionPattern=%d{HH\:mm\:ss,SSS} %5p %20c
{1} %m%n
log4j.appender.CTSWSAppender.DatePattern='.'yyyyMMdd
#---------------------------- DFS ---------------------------log4j.category.com.emc.documentum.fs=DEBUG, DFSAppender
log4j.appender.DFSAppender=org.apache.log4j.DailyRollingFileAppender
log4j.appender.DFSAppender.File=C:/Documentum/cts_ws/logs/DFS_log.txt
log4j.appender.DFSAppender.Append=true
log4j.appender.DFSAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.DFSAppender.layout.ConversionPattern=%d{HH\:mm\:ss,SSS} %5p [%t]
%20c{1} %5x %m%n
log4j.appender.DFSAppender.DatePattern='.'yyyyMMdd
11. Update the transformation.properties file in WEB-INF\classes to have the correct path to
the preferences.xml file.
It will typically appear like the following:
#cts ws preferences config location
55
CTSWSConfig=C:/Documentum/cts_ws/config/preferences.xml
Install the Oracle Weblogic 12c Server and create a new weblogic domain (for example, "ws) as
per the WebLogic Installation Guide.
2.
After the domain creation is complete, all files related to the domain (for example, "ws) are
available under C:\Oracle\Middleware\user_projects\domains\ws (if WebLogic is installed
in C:\Oracle).
3.
Create a folder with name "cts_ws at your working directory (Consider C:\Documentum as
working directory)
a.
56
4.
Open a text editor and create a preferences.xml file with the following content and save it in
the directory %WorkingDir%\cts_ws\config.
Note: This file should contain relevant values for your repository name, domain name (if
applicable), user name, and so on.
<?xml version="1.0" encoding="UTF-8" ?>
<ServiceConfiguration ID="CTS Web Services">
<PropertyList>
<ServerProperty Key="Cache" Description="The Temporary Cache Directory"
Value="C:\Documentum\cts_ws\cache" />
<ServerProperty Key="AllowDirectTransfer" Description="Allow Direct File
Transfer From CTS Server to Client. Set it to false if there is a firewall
restriction" Value="true" />
<ServerProperty Key="CTSWSPingInterval" Description="Interval (in seconds)
used to specify how frequent the LB should ping its CTS instances for heart
rate." Value="180" />
<ServerProperty Key="FailoverRetries" Description="Allow a number of retries
if a request fails while waiting on the HTTP response from CTS" Value="1" />
<ServerProperty Key="InstanceSelector" Description="Specify an implementation
class for instance selection"
Value="com.emc.documentum.cts.lb.workers.DefaultSelector" />
<Repositories>
<AekFilePath>C:\Documentum\cts_ws\config\aek.key</AekFilePath>
<LoginContext DocbaseName="<docbase_name_here>">
<ServerProperty Key="domain" Value="<domain_name_here>" />
<ServerProperty Key="userName" Value="<user_name_here>" />
<ServerProperty Key="passwordFile"
Value="C:\Documentum\cts_ws\config\pfile\mspassword.txt" />
<ServerProperty Key="maxConnectionRetries" Value="10" />
</LoginContext>
</Repositories>
</PropertyList>
</ServiceConfiguration>
5.
Copy the aek.key file from the Content Transformation Services Server machine (located at
C:\Program Files\Documentum\CTS\config) and paste it to C:\Documentum\cts_ws\config
on the Content Transformation Services WebServices/WebLogic host.
6.
Copy the mspassword.txt file from the Content Transformation Services Server machine
(located at C:\Program Files\Documentum\CTS\docbases\<docbase_name>\config\pfile)
and paste it to C:\Documentum\cts_ws\config\pfile on the Content Transformation Services
WebServices/WebLogic host.
7.
Update the dfc.properties file under APP-INF\classes. Enter your docbroker, global
registry details, user name, and password.
It will typically appear like the following:
dfc.data.checkout_dir=${dfc.data.user_dir}/checkout
dfc.data.dir=C:\Documentum\data
dfc.data.export_dir=${dfc.data.user_dir}/export
dfc.data.user_dir=${dfc.data.dir}
dfc.exception.include_decoration=false
dfc.exception.include_id=false
dfc.globalregistry.password=YiYQgefRI63JTWDokb7HJQ==
dfc.globalregistry.repository=CSFPI33_GR
dfc.globalregistry.username=dm_bof_registry
dfc.search.ecis.enable=false
dfc.search.ecis.host=
dfc.search.ecis.port=
dfc.tokenstorage.dir=${dfc.data.user_dir}/apptoken
57
dfc.tokenstorage.enable=false
dfc.docbroker.host[0]=10.31.107.145
dfc.docbroker.port[0]=1489
b. Update the log4j.properties file under APP-INF\classes to point the right location for
all log files. Properties which should be modified are given in bold.
log4j.rootCategory=WARN, A1, F1
log4j.category.MUTE=OFF
log4j.additivity.tracing=false
log4j.category.tracing=DEBUG, FILE_TRACE
#------------------- CONSOLE -------------------------log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.threshold=ERROR
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d{ABSOLUTE} %5p [%t] %-20c{1} - %m%n
#------------------- FILE -------------------------log4j.appender.F1=org.apache.log4j.RollingFileAppender
log4j.appender.F1.File=C:/Documentum/cts_ws/logs/log4j.log
log4j.appender.F1.MaxFileSize=10MB
log4j.appender.F1.layout=org.apache.log4j.PatternLayout
log4j.appender.F1.layout.ConversionPattern=%d{ABSOLUTE} %5p [%t] %-20c{1} - %m%n
#------------------- FILE_TRACE -------------------------log4j.appender.FILE_TRACE=org.apache.log4j.RollingFileAppender
log4j.appender.FILE_TRACE.File=C:/Documentum/cts_ws/logs/trace.log
log4j.appender.FILE_TRACE.MaxFileSize=100MB
log4j.appender.FILE_TRACE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE_TRACE.layout.ConversionPattern=%d{ABSOLUTE} [%t] %-20c{1}
- %m%n
#------------------- CTSWS -------------------------log4j.category.com.emc.documentum.fs.services.transformation=DEBUG, CTSWSAppender
log4j.category.com.emc.documentum.cts=DEBUG, CTSWSAppender
log4j.appender.CTSWSAppender=org.apache.log4j.DailyRollingFileAppender
log4j.appender.CTSWSAppender.File=C:/Documentum/cts_ws/logs/CTSWS_log.txt
log4j.appender.CTSWSAppender.Append=true
log4j.appender.CTSWSAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.CTSWSAppender.layout.ConversionPattern=%d{HH\:mm\:ss,SSS} %5p
%-20c{1} %m%n
log4j.appender.CTSWSAppender.DatePattern='.'yyyy-MM-dd
#------------------- DFS -------------------------log4j.category.com.emc.documentum.fs=DEBUG, DFSAppender
log4j.appender.DFSAppender=org.apache.log4j.DailyRollingFileAppender
log4j.appender.DFSAppender.File=C:/Documentum/cts_ws/logs/DFS_log.txt
log4j.appender.DFSAppender.Append=true
log4j.appender.DFSAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.DFSAppender.layout.ConversionPattern=%d{HH\:mm\:ss,SSS} %5p [%t]
%-20c{1} - %5x %m%n
log4j.appender.DFSAppender.DatePattern='.'yyyy-MM-dd
8.
9.
Copy and paste the updated transformation.ear to the "autodeploy folder located in
C:\bea\user_projects\domains\ws\.
OR
58
b. Perform the following steps to deploy the transformation.ear using the WebLogic admin
console:
Login to WebLogic Admin console using URL: http://localhost:7001/console.
Click the Deployments node from the Domain Structure tree.
Click Install.
Navigate to the location where transformation.ear is available and click Next.
Select Install this deployment as an application and click Next.
Ensure that the name is fetched as "transformation and click Finish.
The application will be in "prepared state. Select "transformation and select Servicing
all requests from the Start menu.
Ensure the state of the transformation application is "Active.
10. Start "startWebLogic.cmd from the domain "ws (C:\Oracle\Middleware\user_
projects\domains\ws). This will automatically deploy the transformation.ear file.
11. Ensure that the TransformationService and ProfileService are accessible from the WebLogic host
and the client machine using the following URLs.
WebLogic machine (runs on port 7001 by default):
http://localhost:<port>/services/transformation/TransformationService
http://localhost:<port>/services/transformation/ProfileService
Remote client machine:
http://<WebLogic_host/ip>:<port>/services/transformation/TransformationService
http://<WebLogic_host/ip>:<port>/services/transformation/ProfileService
12. Send real-time transformation requests using the above Service URL.
13. Check the logs located in the C:\Documentum\cts-ws\logs folder for the complete status of the
Content Transformation Services WebServices server.
2.
3.
Create a folder with the name "cts_ws at your working directory (Consider C:\Documentum
as your working directory).
59
a.
Open a text editor and create a preferences.xml file with the following content and save it in
the directory %WorkingDir%\cts_ws\config.
Note: This file should contain relevant values for your repository name, domain name (if
applicable), user name, and so on.
<?xml version="1.0" encoding="UTF-8" ?>
<ServiceConfiguration ID="CTS Web Services">
<PropertyList>
<ServerProperty Key="Cache" Description="The Temporary Cache Directory"
Value="C:\Documentum\cts_ws\cache" />
<ServerProperty Key="AllowDirectTransfer" Description="Allow Direct File
Transfer from CTS Server to Client. Set it to false if there is a firewall
restriction" Value="true" />
<ServerProperty Key="CTSWSPingInterval" Description="Interval (in seconds)
used to specify how frequent the LB should ping its CTS instances for heart rate."
Value="180" />
<ServerProperty Key="FailoverRetries" Description="Allow a number of retries
if a request fails while waiting on the HTTP response from CTS" Value="1" />
<ServerProperty Key="InstanceSelector" Description="Specify an implementation
class for instance selection" Value="com.emc.documentum.cts.lb.workers.
DefaultSelector" />
<Repositories>
<AekFilePath>C:\Documentum\cts_ws\config\aek.key</AekFilePath>
<LoginContext DocbaseName="<docbase_name_here>">
<ServerProperty Key="domain" Value="<domain_name_here>" />
<ServerProperty Key="userName" Value="<user_name_here>" />
<ServerProperty Key="passwordFile" Value="C:\Documentum\cts_ws\config\
pfile\mspassword.txt" />
<ServerProperty Key="maxConnectionRetries" Value="10" />
</LoginContext>
</Repositories>
</PropertyList>
</ServiceConfiguration>
5.
Copy the aek.keyfile from the Content Transformation Services Server machine (located at
C:\Program Files\Documentum\CTS\config) and paste it to C:\Documentum\cts_ws\config
on the Content Transformation Services WebServices/Tomcat host.
6.
7.
8.
Copy and paste the exploded transformation folder to the "webapps folder of a Tomcat
server configuration. For example, C:\Program Files\Apache Software Foundation\Tomcat
6.0\webapps.
60
a.
61
9.
62
Chapter 6
Installation Troubleshooting
63
Installation Troubleshooting
2.
3.
Run the following command, using the full path to the Java executable on the machine, if it
is not defined as a system variable:
java -cp <installer_jar_file> DiShowVersion
For example, the full command is: java -cp ctsWinSuiteSetup.jar DiShowVersion.
This displays the full installer version.
64
Installation Troubleshooting
The locale setting for the server and for the repository should match. If, for example, the server
machine has a locale setting of UK (en_gb) and the repository has a locale setting of US (en_us), the
cts_instance_info type is not created.
The solution is to change the locale of the machine running the Configurator to match the locale of
the repository, or add the Configurator machines locale to the repository. The locale setting can be
changed using DQL.
The error message will say that a docbase procedure failed to run but will not give any details about
what exactly caused it to fail.
In such cases, you may need to manually clean up the repository of Content Transformation
Services-related items by following the steps below:
1.
2.
3.
Delete the Media Server folder (including all versions and sub folders).
4.
5.
6.
7.
65
Installation Troubleshooting
dmc_cts_reporting_config
dmc_cts_request_archiving
8.
66
Installation Troubleshooting
The problem is that the Japanese, Korean, or Simplified Chinese repository must be populated first
with the English locale (data dictionary). Then the repository should be configured again using
Content Transformation Services Configurator.
To populate the Japanese, Korean, or Simplified Chinese repository with the English locale, perform
the following steps in an English operating system:
1.
2.
3.
When connecting to another docbase the locale of the machine that is making the connection must
be known to the docbase; either the local machine must have the locale of "ko" or the server must
add "en" as an acceptable locale in its local table.
67
Installation Troubleshooting
68
Chapter 7
Installing the Language Pack
Content Transformation Services customers who want to implement language packs have to install
the Content Transformation Services Language Pack. The Content Transformation Services Language
Pack includes the transformation profiles and mapping XML file that are included with Content
Transformation Services. Chapter 1, Installing Content Transformation Services provides information
to install the English Content Transformation Services on the Server operating system. The procedure
for installing Content Transformation Services Language Pack includes:
Installing an Content Transformation Services Language Pack, page 69
Enabling multilingual support in Content Transformation Services, page 70
Ensure that you have performed all of the necessary prerequisites, as outlined in Pre-installation
configuration, page 14 for the English product.
2.
3.
69
4.
Stop all instances of Content Transformation Services connected to the repository you are
updating with the language pack.
2.
3.
In the Resources folder, create separate folders for each language (that is, fr_FR, de_DE,
it_IT,ja_JP, ko_KR, es_ES, zh_CN, ru_RU, pt_BR, en_US).
4.
5.
6.
2.
Restart the instances of Content Transformation Services that are connected to the repository to
which you installed the language pack.
Note: Before using Content Transformation Services language packs, complete Enabling multilingual
support in Content Transformation Services, page 70.
70
This is a simple procedure that is performed through the Windows Control Panel. Once installed, any
language should be displayed properly (provided that the operating system supports the characters
specific to that language). However, there are some drawbacks to the Arial Unicode font as follows:
No italics are available
Spacing and kerning are slightly different compared to the regular Arial font
Double-width diacritic characters are not displayed properly
71
72
Index
A
admin user, 20
architecture, 11
<at least one index entry>, 35
attributes, 47
scalability, 32
uninstalling, 38
CTS DAR
installing, 22
cts_instance_info, 64
configuring
Global registry, 16
configuring an instance, 27
configuring Streaming Server, 47, 49 to 50
connection broker
verifying, 17
Connection Broker
checking services, 18
host, 19
identifying in dfc.properties, 17
Content Server, 15
Connection Broker, 18
installation prerequisite, 14
integrating Streaming Servers, 45
repositories, 18
setting up storage areas, 46
Content Transformation Server
adding an instance, 32
configuring, 27
installation log file, 64
installing, 18
notifications, 20
pre-installation verifications, 17
removing instances, 37
software prerequisites, 14
verifying installation, 43
Content Transformation Services, 11
description, 9
error messages, 20
expanding, 32
installation directory, 19
integrating Streaming Servers, 45
plug-ins, 12
DAR
installing, 22
default_storage, 47
DFC
about, 15
and dfc.properties, 17
directories, 18
installing, 16
migrating, 16
dfc.properties
identifying a Connection Broker, 17
Documentum Administrator
installation prerequisite, 14
Documentum Foundation Classes. See DFC
domain name, 20
E
expanding Content Transformation
Services, 32
F
failed installation, 64
FAST Server, 15
Full Text Index Server, 15
G
Global registry, 16, 20
about, 16
enabling, 32
set up, 16
user name, 21
73
Index
removing an instance, 37
repository, 37
checking, 18
SuperUser, 20
user, 20
repository user, 64
requirements
installation, 18
software, 14
I
installation
directory, 18 to 19
failure, 64
prerequisites, 14 to 15
verifying, 43
installers
downloading, 16
installing, 22
supporting software, 14
instance
adding, 32
configuring, 27
removing, 37
S
scalability
of Content Transformation Services, 32
selecting host, 15
setting up Streaming Server, 46
software prerequisites, 14
startup, verifying, 43
storage areas
setting up for Streaming Servers, 46
Streaming Server, 47, 49 to 50
integration, 45
integration prerequisites, 45
setting up storage areas, 46
setup procedure, 46
SuperUser, 20, 28
SuperUser information, 64
L
locale setting, 64
log file, 64
M
U
migrating profiles, 36
migration of DFC, 16
Migration utility
log file, 36
uninstalling
Content Transformation Services, 38
user
admin, 20
repository, 20
P
plug-ins
Content Transformation Services, 12
prerequisites, 13 to 14
port for CTS Admin, 20
prerequisites
Content Server, 14
Documentum Administrator, 14
third-party applications, 14
profiles
removing, 36
profiles, backing up, 36
profiles, migrating, 36
V
verification
connection broker, 17
verifications
pre-installation, 17
verifying
installation, 43
startup, 43
W
Windows Service, 43
74