EMC Documentum Content Transformation Services for CenterStage

Transcription

1 EMC Documentum Content Transformation Services for CenterStage Version 1.1 Installation and Configuration Guide EMC Corporation Corporate Headquarters: Hopkinton, MA

2 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up to date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners. Copyright 2010 EMC Corporation. All rights reserved.

3 Table of Contents Preface... 9 Chapter 1 About Content Transformation Services Products What is Content Transformation Services? Content Transformation Services scalability CTS High Availability features Plug ins Documentum Foundation Classes What is Thumbnail Generator? Supported file formats Thumbnail Generator capabilities and interoperability What is Advanced Document Transformation Services? Typical Advanced Document Transformation Services Installation Advanced Document Transformation Services plug ins Advanced Document Transformation Services capabilities with CenterStage What is Media Transformation Services? Typical Media Transformation Services Installation Media Transformation Services plug ins Media Transformation Services capabilities with CenterStage Chapter 2 Preparation Upgrading from Document Transformation Services to Advanced Document Transformation Services Selecting the server host Pre Installation steps and requirements Setting up a global registry Software prerequisites Backing up and removing old profiles Viewing log file of migrated profiles Uninstalling previous versions of Documentum transformation software Verify the Connection Broker Identifying a Connection Broker in dfc.properties Checking Connection Broker and repository services Downloading installers Installing Microsoft.NET Framework, Internet Information Services (IIS), ASP.Net, and Microsoft Message Queue (MSMQ) Confirming Print Spooler service for Advanced Document Transformation Services Pre installation checklist Chapter 3 Installing Content Transformation Services Products Content Transformation Services product installation overview EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 3

4 Table of Contents Required installation information Installing CTS DAR files Deleting version 6.0 or earlier DocApps Configuring headless Composer Installing a DAR file with DAR Installer Plugin Installing Advanced Document Transformation Services, Media Transformation Services, or Thumbnail Generator Configuring an instance of Advanced Document Transformation Server, Media Transformation Server, or Thumbnail Generator Clearing Windows Temp directory for Advanced Document Transformation Services Enabling a DFC installation to access a global registry Configuring a CTS product to the global registry Configuring CTS for BOCS Configuring CTS Server to run in SSL Mode Post installation tasks Configuring Thumbnail Generator Processing thumbnails for large files Enlarging thumbnail size for TG Using the SetupCenterStageRenditions Method to configure ADTS and MTS Configuring full screen preview of images for ADTS Configuring full screen preview of images for MTS Chapter 4 Verifying, Expanding, Removing, and Uninstalling Content Transformation Services Products Verifying an installation of Advanced Document Transformation Services, Media Transformation Services, or Thumbnail Generator Verifying startup of Advanced Document Transformation Services, Media Transformation Services, or Thumbnail Generator Verifying installation using CenterStage Configuring a Content Transformation Services product for another repository Removing a Content Transformation Services product instance from a repository Uninstalling a Content Transformation Services product server Uninstalling Content Transformation Services Uninstalling Thumbnail Generator 6.5 SP Chapter 5 Installation Troubleshooting and Tips Third party applications installed on CTS product host should not be used by any other products or users PowerPoint installation user IDs should coincide with MTS Windows Service logon Microsoft Office applications must be activated after installing Checking the version of a CTS product installer Uninstalling/re installing a CTS product Cannot pass SuperUser and repository user information screen The _jvm directory already exists Log file location EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

5 Table of Contents CTS product installation fails COM errors on the CTS product host during installation Modifying the COM access permission settings Setting the default impersonation level If cts_instance_info is not created when the Configurator is executed A Transformation DAR error occurs when upgrading from a previous version Deleting log files Verifying Adlib services started successfully for TG and ADTS Resolving CTS hanging issue Avoiding pop up issues Appendix A Manual Procedures for Configuring ADTS and MTS Configuring Advanced Document Transformation Services Preparing for configuration Registering formats for renditions Configuring full screen preview of images for ADTS Enlarging thumbnail size Completing configuration Configuring Media Transformation Services Preparing for configuration Configuring full screen preview of images for MTS Enlarging thumbnail size Completing configuration EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 5

6 Table of Contents List of Figures Figure 1. Typical Advanced Document Transformation Services installation Figure 2. Typical Media Transformation Services installation EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

7 Table of Contents List of Tables Table 1. Supported formats for thumbnail generation Table 2. Thumbnail Generator capabilities and interoperability with other CTS products Table 3. ADTS capabilities when used with CenterStage Table 4. MTS capabilities when used with CenterStage Table 5. Software prerequisites required for Content Transformation Services products Table 6. Content Transformation Services product Installation Checklist Table 7. Required Content Transformation Services product installation information Table 8. CTS DAR files required for each product Table 9. Description of DAR Installer Fields (CTS DAR) Table 10. Documentum format mapping EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 7

8 Table of Contents 8 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

9 Preface This guide describes how to install and configure Documentum Advanced Document Transformation Services, Media Transformation Services, and Thumbnail Generator for Windows in combination with your Documentum CenterStage system. It lists installation prerequisites and provides step by step instructions for installing and uninstalling these Content Transformation Services products. In addition, this manual includes a brief overview of the Content Transformation Services product architecture. The following documents are also available for the Content Transformation Services product suite: Release Notes: Includes requirements and important notes on installation and administration issues. These documents also references some known problems, limitations, and problems fixed in that release. The following Release Notes documents are available: Advanced Document Transformation Services Release Notes Media Transformation Services Release Notes Installation Guides: Describes each product s typical installation and capabilities, how to install your Content Transformation Services product, and how to configure repositories with the product. Also includes instructions for installing and configuring your product with the CTS Activity Template and CTS WebServices. The following Installation Guides are available: Advanced Document Transformation Services Installation Guide Media Transformation Services Installation Guide Content Transformation Services Profile Modification Guide, which provides instructions for modifying profiles used by Documentum Content Transformation Services products. Content Transformation Services Product Development Guide, which explains how to use the plug in SDK to create and configure your own plug ins for Content Transformation Services products. Contact your account representative for availability of the Content Transformation Services Product Development Guide. Thumbnail Generator is only available with Documentum CenterStage. There is no other documentation available for Thumbnail Generator at the time of this release. See the appropriate Documentum product documentation for information on related Documentum products. Intended audience This guide is intended for the person who installs Advanced Document Transformation Services, Media Transformation Services, or Thumbnail Generator in your CenterStage system, often called the system administrator or system operator. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 9

10 Preface 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 history Revision date August 2010 Description Initial publication. 10 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

11 Chapter 1 About Content Transformation Services Products EMC Documentum CenterStage provides inline viewers that display the first page of a document with a thumbnail. Documentum Thumbnail Generator (TG) creates single page thumbnails (100 x 100 pixels in size by default, but configurable to a maximum of 300 x 300) for images, PDF files, and Office documents that are displayed in the inline viewers. Optionally, you can use Documentum Media Transformation Services (MTS) or Documentum Advanced Document Transformation Services (ADTS) instead of Thumbnail Generator to provide full screen, multi page document and image viewing capabilities in addition to thumbnails. Thumbnail Generator is operable with ADTS and MTS on the same host (versions 6.5 SP3 and 6.6 only). However, ADTS and MTS will take priority and control operations for files they can process. Note: All CTS products on the same host must be of the same version. This chapter contains the following sections: What is Content Transformation Services?, page 12 briefly describes each of the CTS products and the scalability of the CTS product suite. CTS High Availability features, page 13 describes high availability features of CTS products. Plug ins, page 13 describes a CTS plug in. Documentum Foundation Classes, page 14 describes the DFC and its role in CTS products. What is Thumbnail Generator?, page 14 describes the Thumbnail Generator product, including supported file formats, capabilities and interoperability with other CTS products. What is Advanced Document Transformation Services?, page 16 describes a typical ADTS installation, including plug ins, and ADTS capabilities. What is Media Transformation Services?, page 18 describes a typical MTS installation, including plug ins, and MTS capabilities. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 11

12 About Content Transformation Services Products What is Content Transformation Services? Content Transformation Services (CTS) is a suite of Documentum server products that perform transformations and analysis on repository content. The following CTS products may be used with CenterStage: Thumbnail Generator (TG) Included only with the CenterStage product and installed explicitly with CenterStage Advanced Document Transformation Services (ADTS) Media Transformation Services (MTS) In addition, the following CTS products may also be configured in your system, but are not currently supported with CenterStage: Document Transformation Services (DTS) XML Transformation Services (XTS) Additional components may be available for some of products. For example, Media Transformation Services may also include Audio/Video Transformation Services (AVTS). Content Transformation Services scalability Content Transformation Services (CTS) products allow for a high level of scalability. All CTS products run under the same Windows Service on the CTS host. This means that stopping or starting the CTS service stops or starts all the CTS products on that host. For example, if your CTS host contains Advanced Document Transformation Services and Media Transformation Services, stopping the CTS Windows Service stops both of those products. Each CTS product can be configured for multiple repositories. If you have one installation of a product on a host, that installation can be configured against different repositories. CTS scalability also allows for several instances of Content Transformation Services products on different hosts to be configured for the same repository. This means that your installation can take either of two forms: one with identical plug in capabilities, or one with different plug in capabilities. The ability for each Content Transformation Services product instance to handle different plug ins means that you can have each instance dedicated to a specific type of transformation. For example, you might have a dedicated Media Transformation Server for transforming images to JPEG images, and a dedicated Media Transformation Server for all other tasks. In this case, each instance has different plug ins, but all instances point to the same repository. Each server accepts only those items from the processing queue that it is capable of handling. In addition, having multiple Content Transformation Services product installations will not prevent queue items from being processed in the event of a failure in one instance. To enable this functionality, Content Transformation Services has format awareness. Format awareness is the ability for a Content Transformation Services product to recognize which file formats it is capable of processing. Items that cannot be processed successfully will be removed from the queue automatically. For example, if several transformation requests are made for JPEG files, but the product does not support JPEGs, the system will remove those items from the queue. A check for unprocessed items is performed periodically. 12 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

13 About Content Transformation Services Products CTS High Availability features CTS provides the following high availability mechanisms to help minimize downtime and keep critical enterprise systems productive in any given environment: Failover With multiple instances of CTS, if any instance that polls the queue item is found incapable of performing the queue request, the queue item will be put back into the repository and will be polled by another capable instance eventually. The invalid queues will get deleted upon reaching expiry. Plug in failover scheme When two or more plug ins with similar functionality are available to undertake a specified profile transformation, CTS calls the next available plug in in the chain, in case of failure, to complete the service request. Internal task monitor Each task is monitored internally for any unresponsive threads. When triggered, CTS automatically attempts to recover from ʺbeing stuck either by shutting down the stuck thread or, in a critical situation, by shutting down the CTS instance. The Internal task monitor can trigger a shut down where CTS then enters After crash error recovery mode. After crash error recovery After a crash, CTS starts in single threaded mode to reprocess items worked on just before the crash. The system goes into multi threaded mode once all prior items are processed. There is also logic to remove jobs that continually cause CTS to crash. Plug in monitor Each plug in can be started (optionally) with its own monitor to watch for unresponsiveness. CTS monitor An external process monitoring restarts CTS in the event of a failure. Plug ins Plug ins are extensible. You can configure plug in types and formats, and you can add new plug ins to the system to support new file formats as required. For information about creating and adding new plug ins, see the Content Transformation Services Product Development Guide, the Content Transformation Services Profile Modification Guide or contact your Documentum account or support representative. Note: Plug ins are extensible for all CTS products except for Thumbnail Generator. During an installation of a Content Transformation Services product, all standard plug ins are installed. There may be prerequisite, third party applications required for some of the standard plug ins. For more information on applications see the Installation Guide for your Content Transformation Services product. For information on specific versions supported with your product, see the Release Notes document for your Content Transformation Services product. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 13

14 About Content Transformation Services Products Documentum Foundation Classes The Documentum Foundation Classes (DFC) are a set of Java classes that provide access to Content Server functionality. DFC must be installed on the Content Transformation Services product host, and is included with each installer. During installation, the Content Transformation Services product installer checks for an existing DFC on the host. The following scenarios are possible: If DFC does not exist on the host, the installer installs the correct version. If an older version of DFC exists on the host, it is replaced by the version included with the installer. Refer to the relevant version of the Documentum System Upgrade and Migration Guide available on the EMC Powerlink at for more information on migration issues. Any applications that were dependent upon the older version of the DFC will have to be upgraded as well. For more information on the DFC and its effect on other applications, refer to your specific Documentum application documentation. If a version of DFC exists and it is newer than that which is included with the installer, it will be refreshed. What is Thumbnail Generator? Thumbnail Generator is a member of the Documentum Content Transformation Services suite of products that is available only with an installation of Documentum CenterStage. Thumbnail Generator creates single page thumbnails (300x300 in size by default, but configurable) for images, PDF, and Office documents. The generated thumbnails are used in various parts of the application to provide previews of content. Thumbnail Generator is integrated with Documentum Content Server to process, store, and manage files within the Documentum repository. When importing an applicable file type into the Documentum repository, the Content Server adds that request to a queue. Thumbnail Generator polls the queue intermittently, looking for register requests. The requests are analyzed and they are sent to the appropriate plug in for processing. Thumbnail Generator generates a thumbnail of the file. The thumbnails are saved to the repository and the requests are removed from the queue. The objects are then ready for use. Users browse metadata for the objects and view thumbnails and low resolution renditions. CenterStage can provide full document viewing capabilities after an upgrade to Advanced Document Transformation Services or Media Transformation Services. Note: Advanced Document Transformation Services (ADTS) provides a superset of Thumbnail Generator functionality. It is recommended that rather than install ADTS along with Thumbnail Generator, uninstall Thumbnail Generator and install ADTS. Note: If you deploy TG to an existing repository, TG cannot process legacy content. 14 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

15 About Content Transformation Services Products Supported file formats Thumbnail Generator can generate thumbnails for the following file formats. Table 1. Supported formats for thumbnail generation File type Images Supported formats BMP, DNG, EPS, FPX, GIF, HTML, JPEG, JPEG2000, PNG, PSD, MACP, PBM, PCD, PCX, PGM, PICT, PNM, PPM, RLE, SCT, SGI, TIFF, SVG, TGA, WBMP, AI Documents EXCEL8BOOK, EXCEL8TEMPLATE, EXCEL12BOOK, EXCEL12TEMPLATE, POWERPOINT, ACAD, DWF, MSPROJECT, MSW8, MSW8TEMPLATE, MSW12, MSW12TEMPLATE, PDF, PPT8, PPT8_TEMPLATE, PPT12, PPT12TEMPLATE, PS, VSD, VSD2, VSD3, VSD4 Thumbnail Generator capabilities and interoperability Depending on what other Content Transformation Services products you have installed, all requests for the system to generate and return thumbnails may be processed by the Thumbnail Generator. Depending on what other Documentum CTS products (Media Transformation Services or Advanced Document Transformation Services) you have installed with your deployment, you may have the ability to generate thumbnails for a variety of file types. Table 2, page 15 illustrates the capabilities of Thumbnail Generator on its own and when it is installed with other Documentum Content Transformation Services products. Table 2. Thumbnail Generator capabilities and interoperability with other CTS products CTS product(s) Image thumbnails Document thumbnails Storyboard (all documents) Storyboard (PDF & PPT only)* TG MTS ADTS ** TG & MTS TG & ADTS MTS & ADTS * Only MTS can generate storyboards for PPT and PDF files out of the box. See the Advanced Document Transformation Services Administration Guide for instructions on configuring ADTS to generate thumbnails and storyboards for any document format. ** ADTS can generate thumbnails for some image formats (i.e. jpeg, tiff, bmp, gif), but this must be configured. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 15

16 About Content Transformation Services Products If only TG is configured, thumbnails for the supported images and documents will be done through TG. If TG and MTS are configured against the repository, image thumbnailing is performed by MTS, and document thumbnailing is performed by TG If TG and ADTS are configured and if ADTS has been configured for thumbnailing, then Document thumbnailing is performed by ADTS. What is Advanced Document Transformation Services? Advanced Document Transformation Services is server software that generates copies of documents in Portable Document Format (PDF), PDF text, PostScript, and HyperText Markup Language (HTML). You can use Documentum client applications to request such a copy (called a rendition) of a document stored in a Documentum repository. The transformation capabilities of Advanced Document Transformation Services include PDF assembly, header/footer creation, security, textual watermarking, and content overlays. Advanced Document Transformation Services can also provide PDF transformations from other file formats such as image and formats. Some Documentum client applications may not provide both PDF and HTML renditions; consult the documentation for the client you are using. Typical Advanced Document Transformation Services Installation Figure 1, page 16 shows a typical Advanced Document Transformation Services installation on the Documentum platform. Figure 1. Typical Advanced Document Transformation Services installation 16 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

17 About Content Transformation Services Products Advanced Document Transformation Services plug ins The Advanced Document Transformation Server plug ins enable users to transform a variety of files from one format to another (for example, from DOC to PDF or HTML). The standard Advanced Document Transformation Server plug ins are as follows: Word transforms Microsoft Word files to HTML. Excel transforms Microsoft Excel files to HTML. PowerPoint transforms Microsoft PowerPoint files to HTML. WordPerfect transforms Corel WordPerfect files to HTML. AdvancedPDF enables PDF support and creates hyperlinks and bookmarks. PDF Storyboard generates thumbnails and storyboards. MIME transforms MSG and EML files to text or rich text. EMCMail transforms EMCMF to PDF and HTML. During an installation of Advanced Document Transformation Services, all standard plug ins are installed. There may be prerequisite, third party applications required for some of the standard plug ins. For more information applications see Software prerequisites, page 24. For information on specific versions supported with Advanced Document Transformation Services, see the Advanced Document Transformation Services Release Notes. Advanced Document Transformation Services capabilities with CenterStage Table 3. ADTS capabilities when used with CenterStage Input format Thumbnail images Full screen, multi page views AutoCad BPM Office (DOC, DOCX, DOT, DOTX, PPT, PPTX, POT, POTX, XLS, XSLX, XLT, XLTX, VSD) Images (GIF, JPEG, TIFF) WPD RTF, TXT PS PDF HTML EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 17

18 About Content Transformation Services Products What is Media Transformation Services? Media Transformation Services (MTS) is server software that integrates with Content Server to perform analysis and transformation activities for media file formats. Thumbnail, storyboard, and low resolution renditions are generated automatically. Media transformations can be triggered automatically by certain events, such as when an object is versioned, or as requested by users. The Media Transformation Services software package includes the following major components: Media Transformation Server Thumbnail Server Audio/Video Transformation Services (AVTS is an optional product that is not included with the purchase of Media Transformation Services.) Typical Media Transformation Services Installation Figure 2, page 18 shows a typical Media Transformation Services installation on the Documentum platform. Figure 2. Typical Media Transformation Services installation Media Transformation Services plug ins The Media Transformation Server plug ins identify and extract media specific properties, such as height, width, color mode, and compression, and generate thumbnails and low resolution renditions of objects. The plug ins also enable the transformation of media files from one format to another (for example, from TIFF to JPEG) and provide users with the ability to perform transformations such as resizing, flipping, or rotating an image. 18 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

19 About Content Transformation Services Products The standard Media Transformation Services plug ins are as follows: PowerPoint generates thumbnails, low resolution renditions, storyboards, and slide objects for PowerPoint files. Image 1 processes images and other file formats. Generates thumbnails, generates low resolution renditions, extracts properties, and performs transformations such as resize and transformto. Image 2 processes images and other file formats. Generates thumbnails, generates low resolution renditions, extracts properties, and performs transformations such as resize. Image 3 processes images and other file formats. Generates thumbnails, generates low resolution renditions, and extracts properties of large image files. This plug in also generates thumbnails, generates low resolution renditions, extracts properties, and creates storyboards for PDF files. PDF Storyboard generates thumbnails, low resolution renditions, and storyboards for PDF files. XMP extracts metadata from image and document (PDF) formats. EXIF extracts EXIF metadata from image files that have embedded EXIF metadata. During an installation of Media Transformation Services, all standard plug ins are installed. There may be prerequisite, third party applications required for some of the standard plug ins. For more information applications see Software prerequisites, page 24. For information on specific versions supported with Media Transformation Services, see the Media Transformation Services Release Notes. Media Transformation Services capabilities with CenterStage The following table shows the image and document formats supported by Media Transformation Services: Table 4. MTS capabilities when used with CenterStage Input format Thumbnail images Full screen, multi page views Images (AI, BMP, DNG, EPS, FPX, GIF, JPEG, PGM, PNG, PNM, PPM, PSG, SVG, TIFF, WBMP) Office (PPT, PPTX, POT, POTX) PDF EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 19

20 About Content Transformation Services Products Note: In addition, MTS provides a set of image editing options. 20 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

21 Chapter 2 Preparation This chapter explains how to prepare for installing Advanced Document Transformation Services, Media Transformation Services, and Thumbnail Generator on a Windows host. It describes pre installation requirements. This chapter contains the following sections: Upgrading from Document Transformation Services to Advanced Document Transformation Services, page 21 describes important information for customers who are upgrading from Document Transformation Services to Advanced Document Transformation Services. Selecting the server host, page 22 describes requirements for selecting the server host. Pre Installation steps and requirements, page 22 describes tasks that are required or are optional before installing your products. Pre installation checklist, page 29 lists all the decision points and information that the installer requires in order to complete the installation and provides a checklist for entering this information. Upgrading from Document Transformation Services to Advanced Document Transformation Services If you are upgrading from Document Transformation Services to Advanced Document Transformation Services, review the information in this section. Note: Advanced Document Transformation Services is still a stand alone product. Document Transformation Services is not a prerequisite for Advanced Document Transformation Services. When upgrading from Document Transformation Services to Advanced Document Transformation Services, it is not necessary to uninstall Document Transformation Services first. The Advanced Document Transformation Services installer will add the necessary profiles and components to the server. These actions occur when you upgrade from Document Transformation Services to Advanced Document Transformation Services: The DTS configuration tool, registry entry, and Add/Remove Programs entry are all removed from the host. If ADTS is configured against the same repository as DTS, the cts_instance_info entry is overwritten. Therefore, DTS no longer exists on the host. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 21

22 Preparation There is no special upgrading procedure; simply follow the installation procedure for Advanced Document Transformation Services in this guide. Remember that it is not necessary to uninstall Document Transformation Services before upgrading. All Document Transformation Services components are also removed from the server when Advanced Document Transformation Services is uninstalled. Therefore, if you need to restore Document Transformation Services on this server, you must reinstall Document Transformation Services. In cases where Advanced Document Transformation Services and Document Transformation Services are configured to the same repository but installed on different hosts, removing the Advanced Document Transformation Services instance will not affect the Document Transformation Services instance. Only the Advanced Document Transformation Services profiles are unconfigured when Advanced Document Transformation Services is removed from a repository. Selecting the server host This section provides basic guidelines for selecting the host machine for your Content Transformation Services product installation. Caution: To ensure optimal system performance, the Content Transformation Services product should not be: Installed on the same host as Content Server or the FAST (Full Text Index) Server. This configuration is not supported. The server name cannot exceed 15 bytes (an error message will display during installation when trying to enter a host name that is longer than 15 bytes). When selecting the CTS product host, consider the amount of memory on the candidate server. Content Transformation Services products requires an amount of memory equal to at least twice the size of the largest file you expect to process. For example, if you expect users to work with 1 GB files, the host must have at least 2 GB of memory to ensure efficient media processing. As well, all Content Transformation Services products installed on a host use the same Windows service. This means that any actions (such as starting or stopping an application) performed on that Windows service affect all of the CTS products using it. The number of products installed on a single host, the expected usage of those products, and the host s hardware capabilities are major factors in selecting the host. If you are planning to use the same host for more than one CTS product, ensure that it has sufficient hardware and processing capabilities for optimal performance. For more information on CTS scalability, see Content Transformation Services scalability, page 12. Refer to the Media Transformation Services Release Notes or Advanced Document Transformation Services Release Notes for complete information on hardware and software requirements. Pre Installation steps and requirements This section explains what to do before you install a Content Transformation Services product and describes prerequisites for a successful installation. 22 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

23 Preparation The Media Transformation Services Release Notes and Advanced Document Transformation Services Release Notes provide complete information on hardware, operating system, and software version requirements. The following steps should be followed before installing your Content Transformation Services product: Setting up a global registry, page 23 Software prerequisites, page 24 Backing up and removing old profiles, page 25 Uninstalling previous versions of Documentum transformation software, page 26 Verify the Connection Broker, page 27 Downloading installers, page 28 Installing Microsoft.NET Framework, Internet Information Services (IIS), ASP.Net, and Microsoft Message Queue (MSMQ), page 28 Confirming Print Spooler service for Advanced Document Transformation Services, page 29 Setting up a global registry When a global registry is enabled, you can deploy service based objects automatically from the central repository designated as the global registry, and network locations created in the global registry are available in distributed configurations. The global registry is enabled during repository configuration. There is no limit to how many repositories may be configured as global registries; however, you may need more than one global registry if you have applications that have very different user access levels. If the global registry does not have the Content Transformation Services product configured against it, then the transformation and rich_media_services DARs need to be manually run against the global registry. See Enabling a DFC installation to access a global registry, page 45 for further information. To set up a global registry: 1. Determine which repository will function as the global registry. 2. During repository configuration, you will be 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 user s account is used by DFC 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 DFC on client machines, provide those DFC installations with the global user login credentials. This applies to Desktop installations on end user computers, to WDK based clients such as Webtop on application server host, and to the DFC instance on Content Server and remote Content Server hosts. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 23

24 Preparation 4. Ensure that the global registry repository projects to connection brokers known to the DFC instances that must access the global registry. Identifying a Connection Broker in dfc.properties, page 27 provides instructions. Software prerequisites This section describes the prerequisites for a successful Content Transformation Services product installation. Before installing Advanced Document Transformation Server, Media Transformation Server, or Thumbnail Generatoryou must install several applications and other components on the server host. The Media Transformation Services Release Notes and Advanced Document Transformation Services Release Notes provide complete information on hardware, operating system, and software version requirements for those products. See the CenterStage Release Notes for the versions of those products supported for this release. The following Documentum software must be installed, configured, and running properly on your network before you install your Content Transformation Services products: Documentum Content Server Documentum Composer to install DAR files Documentum Administrator Table 5, page 24 details the third party products or components that must also be installed, configured, and running properly on your Content Transformation Services product host. Note: Ensure that all applications are installed to their default location. Content Transformation Services products look to each application s default installation directory when it needs to launch an application. Make sure all installed programs have been launched and the registration dialog box no longer appears. The registration screen that appears in some newly installed programs may interfere with processing. Also, all applications must be closed prior to installing your Content Transformation Services product. Table 5. Software prerequisites required for Content Transformation Services products Prerequisite TG ADTS MTS More Information Microsoft Windows as the operating system Microsoft Office Microsoft PowerPoint to use the PowerPoint plug in (optional) Ensure that all Office applications are launched and all initial launching prompts (for example, any activate license prompts) are dismissed. 24 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

25 Preparation Prerequisite TG ADTS MTS More Information Optional rendering applications (that is, Microsoft Visio, Microsoft Project, Corel WordPerfect, AFPL Ghostscript, Acrobat Reader) Internet Explorer 6.0 (or later) GPL Ghostscript to allow the Image 3 plug in to process PDF files (optional) products/winfamily/ie/default.mspx Microsoft.NET Framework * *.NET Framework 2.0 (latest service pack) may require additional rendering applications: com/downloads/details.aspx?familyid= 79BC3B77 E02C 4AD3 AACF A7633F706BA5&displaylang=en Microsoft Message Queue (MSMQ) Internet Information Services (IIS) and ASP.Net The only component of MSMQ required by Thumbnail Generator is Common. windowsserver2003/technologies/ msmq/default.mspx For IIS, see: windowsserver2003/iis/default.mspx WinZip or a similar file extraction utility is installed on the host machine. For ASP.net, see: Note: Installing Microsoft.NET Framework, Internet Information Services (IIS), ASP.Net, and Microsoft Message Queue (MSMQ), page 28 provides installation instructions for.net Framework, MSMQ, IIS, and ASP.Net. Note: All third party products must be purchased and licensed by the customer with the exception of any products installed by a CTS product installer. Backing up and removing old profiles If you have customized or added any profiles on a repository that was previously configured with a CTS product, these profiles will be migrated automatically during installation and configuration of your chosen version of the CTS products to use with CenterStage. However, it is strongly EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 25

26 Preparation recommended that all profiles be backed up manually prior to installing your chosen version of the CTS products to use with CenterStage. Export a copy of all profiles to a local disk before making any changes to your installation. It is also recommended, but not mandatory, to remove old profiles from the repository before installing this version. This ensures that only the current profiles included with your chosen version of the CTS products to use with CenterStage are contained within the Media Server folder. To back up and remove profiles from a previous installation: 1. On the repository where your CTS product is configured, navigate to /System/Media Server. 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). Viewing log file of migrated profiles During installation of Advanced Document Transformation Services, a dialog box appears with 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. You can view the log file generated by the profile migration tool. This log file shows the profiles that were processed, their status, and the reason why if any profiles were not migrated. The default location of the log file of migrated profiles is C:\Program Files\Documentum\CTS\migration\log. The migration log file shows the result of the migration process: migration_log_2007_292_ txt > Migration log; The migration report log shows a complete list of all profiles before they are upgraded: migration_report_2007_292_ txt > Report log Uninstalling previous versions of Documentum transformation software In order to work properly together, all Content Transformation Services products residing on the same host must be of the same version. Therefore, before you install Advanced Document Transformation Services, you must uninstall any previous versions of Content Transformation Services products, including Content Rendition Services (as Document Transformation Services Legacy was known prior to version 5.3), or AutoRender Pro (as it was known prior to version 5.2), or Media Server (as Media Transformation Services was known prior to version 5.3). To uninstall 26 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

27 Preparation version 5.3 of a Content Transformation Services product, refer to the Release Notes for the current version or the 5.3 version. Note: To uninstall Thumbnail Generator 6.5 SP1 (installed with the initial release of Documentum CenterStage Pro), go to Uninstalling Thumbnail Generator 6.5 SP1, page 59. To uninstall previous Content Rendition Services or AutoRender Pro installations: 1. On the host machine, select Start > Settings > Control Panel and double click Add/Remove Programs. 2. In the Change or Remove Programs window, locate the AutoRender Pro or Content Rendition Services program. Select it, and click Change/Remove. 3. In the Change/Remove dialog box, click Next. 4. Follow the steps in the Uninstall Wizard. 5. If it exists, delete the ARP subdirectory located in your Documentum installation directory. 6. Find any previous versions of the following files and/or directories and delete them: C:\WINNT\system32\arpgen.exe C:\dmautop (delete entire directory) Caution: Consult the Release Notes for the specific version of Content Rendition Services or AutoRender Pro that exists on the host for any known uninstallation issues. Verify the Connection Broker Prior to installation, verify the following: If you already have a dfc.properties file, it is pointing to the correct Connection Broker. Identifying a Connection Broker in dfc.properties, page 27 provides instructions. The Connection Broker and repository services are running on your Content Server. Checking Connection Broker and repository services, page 28 provides more information on this topic. Identifying a Connection Broker in dfc.properties If you already have Documentum Foundation Classes (DFC) installed on your Advanced Document Transformation Services host, you will have a dfc.properties file. Follow this procedure to ensure that the correct Connection Broker is specified. If you are installing Advanced Document Transformation Services on a clean host, you will not have a dfc.properties prior to installation; in this case, the following procedure is not required. For more information on the Connection Broker, see the Documentum Administrator User Guide. To identify the correct Connection Broker in dfc.properties: 1. Search for the dfc.properties file on your Advanced Document Transformation Services host. The file is usually located in the Windows (C:\Documentum\config.) folder. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 27

28 Preparation 2. Open dfc.properties in a text editor. 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. Save and close the dfc.properties file. Checking Connection Broker and repository services The Connection Broker and repository services must be running properly on the Content Server host before you install Advanced Document Transformation Services. The Content Server Administration Guide should be referenced for information and instructions pertaining to Connection Broker and repository services. Downloading installers Before beginning the installation process, it is best to have the installer(s) ready and available on your chosen host. The EMC Powerlink site ( provides access to the EMC Software Download Center ( where a complete listing of products is available for download. The download files for Thumbnail Generator are listed under Documentum CenterStage. The download files for ADTS are listed under Documentum Advanced Document Transformation Services and the files for MTS are listed under Documentum Media Transformation Services. Download the installer to a temporary directory on your Content Transformation Services product host. Unzip any zipped files before you proceed with the installation. Installing Microsoft.NET Framework, Internet Information Services (IIS), ASP.Net, and Microsoft Message Queue (MSMQ) Use the following procedures to install or enable Microsoft.NET Framework, Internet Information Services (IIS), ASP.Net, and Microsoft Message Queue (MSMQ). Note:.NET Framework 1.1 is required on the ADTS server. In addition to 1.1, one of.net versions 2.0 or 3.0 or 3.5 with the latest hotfix, must also be installed. Note: The Adlib Web Express server component of the TG installation requires IIS to be on port 80. If IIS is on a different port, you can temporarily set IIS to port 80 before installing TG. Once TG is installed and you set IIS back to the non 80 port, you must configure Adlib to use the non standard port. To install Microsoft.NET Framework: 1. Go to the Microsoft download site at us/netframework/default.aspx 28 EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide

29 Preparation Follow the directions for installing the version of Microsoft.NET Framework specified in the Media Transformation Services Release Notes. To enable ASP.Net on the server: 1. Select Start > All Programs > Administrative Tools > IIS Manager. 2. In IIS Manager, expand the server name in the left navigation panel. 3. Double click to open Web Service Extensions. 4. In the right panel, select the ASP.Net entry and select Allow. 5. Restart the server to implement the change. To install Microsoft Message Queuing 1. Select Start > Control Panel > Add or Remove Programs. 2. Select Add/Remove Windows Components. 3. In the Components box, click Application Server. 4. Click Details. 5. Select the Message Queuing checkbox. 6. Verify that Application Server Console, Enable Network COM+ Access, Internet Information Services (IIS), and Message Queuing are all selected. 7. Click OK. Confirming Print Spooler service for Advanced Document Transformation Services A Microsoft Windows service called Print Spooler must be running before you install any applications. PDF files cannot be generated without this service. To check that the Print Spooler service is started: 1. Go to Start > Control Panel > Administrative Tools > Services. 2. Locate Print Spooler by scrolling through the list box. 3. Ensure that the Print Spooler status is Started, and that the Startup Type is Automatic. 4. If changes are required, double click on Print Spooler to open the dialog box. 5. Make the required changes, and click Apply. Pre installation checklist Use this checklist to ensure you have performed all required tasks before you install a Content Transformation Services product. EMC Documentum Content Transformation Services for CenterStage 1.1 Installation and Configuration Guide 29