EMC Documentum Content Services for SAP Repository Manager

Transcription

1 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide P/N Rev A01 EMC Corporation Corporate Headquarters: Hopkinton, MA

2 Copyright EMC Corporation. All rights reserved. Published September 2007 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.

3 Table of Contents Preface... 9 Chapter 1 Introducing Content Services for SAP Repository Manager Overview Understanding the Repository Manager architecture Understanding SAP and Repository Manager terms Chapter 2 Installing Content Services for SAP Portal Repository Manager Overview Installation prerequisites General prerequisites Software prerequisites Preinstallation tasks Overview Common preinstallation tasks Overview Obtaining the latest copy of the product from the EMC Documentum Download Center Ensuring that the EMC Documentum repository is working Configuring EMC Documentum Content Server Ensuring that Java is installed Configuring client side setup Verifying DFC installation Verifying the SAP NetWeaver installation Configuring LDAP settings for EMC Documentum Content Server and SAP NetWeaver Updating EMC Documentum custom repository properties Copying logging related files Windows specific preinstallation tasks Configuring SAP NetWeaver UNIX specific preinstallation tasks Overview Preparing Tomcat Overview Installing Tomcat Configuring Tomcat Preparing Sun Java System Application Server Configuring SAP NetWeaver Installing Repository Manager Overview Installing Repository Manager using SDM Installing Repository Manager using Visual Administrator Installing Repository Manager using Administration Console Significant installation related system files and folders Overview EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 3

4 Table of Contents log4j_rm.properties com.documentum.ei.eprm.manager.dctmrepositorymanager Postinstallation configuration Overview Configuring SAP NetWeaver Overview Copying DFC related JAR files In Windows In UNIX Copying Repository Manager related images Configuring Repository Manager instances Working with custom repository properties Overview Extracting and deploying custom repository properties Overview Prerequisites for extracting and deploying custom repository properties Extracting custom repository properties Deploying custom repository properties Overview Deploying custom EMC Documentum repository properties using SDM Deploying custom EMC Documentum repository properties using Visual Administrator Deploying custom EMC Documentum repository properties using Administration Console Verifying deployed custom repository properties Configuring display of custom repository properties Overview Specifying Dynamic Values Class Configuring metadata extensions for properties Chapter 3 Upgrading Content Services for SAP Portal Repository Manager Overview Upgrade scenarios Upgrade prerequisites Preupgrade tasks Repository Manager 5.3 SP Repository Manager 5.3 SP Delete the resource type dm_message_archive Uninstall RM 5.3 SP Obtain the current copy of the product Upgrading to Repository Manager Chapter 4 Verification Overview Verifying the installation Verifying the postinstallation tasks Chapter 5 Troubleshooting Overview Case sensitivity issues when using principal authentication Problem statement EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

5 Table of Contents Possible causes Suggested resolution High levels of logging Knowledge Management component does not startup Case Problem statement Possible causes Suggested resolution Case Problem statement Possible causes Suggested resolution Item not found in SAP Portal Problem statement Possible causes Suggested resolution Certain properties do not exist for a document type Problem statement Possible causes Suggested resolution Index unable to crawl through a repository Problem statement Possible causes Suggested resolution Repositories are not displayed in SAP Portal Problem statement Possible causes Suggested resolution Unable to execute the EMC Documentum property extractor utility Problem statement Possible causes Suggested resolution SAP Web AS does not start Problem statement Possible causes Suggested resolution Repository Manager uses the EMC Documentum s default log file Problem statement Possible causes Suggested resolution Chapter 6 Uninstalling Content Services for SAP Portal Repository Manager Overview Preuninstallation tasks Overview Removing custom Repository Manager settings in Enterprise Portal Overview Deleting references to Repository Manager instances Undeploying custom repository properties Undeploying custom repository resource bundles Overview Undeploying custom repository resource bundles using SDM EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 5

6 Table of Contents Undeploying custom repository resource bundles using Visual Administrator Undeploying custom repository resource bundles using Administration Console Resetting metadata extensions for properties Deleting all Repository Manager instances Uninstalling Repository Manager Overview Uninstalling Repository Manager using SDM Uninstalling Repository Manager using Visual Administrator Uninstalling Repository Manager using Administration Console Postuninstallation tasks Overview Common postuninstallation tasks Overview Removing custom EMC Documentum Content Server settings Removing custom client side settings Removing custom DFC settings Removing custom LDAP configuration settings Deleting Repository Manager related images Windows specific postuninstallation tasks Removing custom SAP NetWeaver settings UNIX specific postuninstallation tasks Overview Removing custom SAP NetWeaver settings Removing custom Tomcat settings Removing custom Sun Java System Application Server settings EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

7 Table of Contents List of Figures Figure 1. Content Services for SAP Repository Manager architecture EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 7

8 Table of Contents List of Tables Table 1. Terms and definitions Table 2. Parameters for new Repository Manager instance EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

9 Preface Purpose of this guide This guide explains how to install and perform initial configuration of Content Services for SAP Portal Repository Manager 6.0 (Repository Manager 6.0). It contains information about installation requirements, and provides task based instructions for installing the software. Note: For the sake of brevity, throughout this document, Content Services for SAP Portal Repository Manager will be referred to as Repository Manager. Intended audience This manual is primarily intended for qualified consultants and system administrators. This role covers those who install and configure Content Services for SAP Portal Repository Manager. The Content Services for SAP Portal Repository Manager application integrates two enterprise level software packages: the Documentum content management system with the SAP NetWeaver platform. Content Services for SAP Portal Repository Manager requires detailed knowledge of SAP NetWeaver and SAP Portal. Consultants and system administrators must have experience with the software products listed in the Software requirements section of the EMC Documentum Content Services for SAP Portal Repository Manager Release Notes. Revision history This section contains a description of this document s revision history. Revision history Revision date September 2007 Description Initial publication of document for Content Services for SAP Portal Repository Manager 6.0. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 9

10 Preface Typographic conventions This guide uses the following typographic conventions. Typographic conventions used in this guide Convention Description > Represents a pop up or pull down menu. <Text enclosed within angle brackets> Information in this font Represents a variable name for which you must provide a value, or a defined term. Represents code samples, user input, and computer output. [] square brackets Used in method command syntax specifications, square brackets indicate an optional argument. {} curly brackets Used in method command syntax specifications, curly brackets indicate an optional argument that can be repeated more than once. Related documentation This guide forms part of a documentation suite designed to support those who install, configure, and use RM. The product and documentation suite can be found on EMC Documentum s Download Center: From Powerlink, you can download the latest version of RM and the related documentation suite. To access the contents in Powerlink, you must provide the login credentials assigned to you when you first applied for access. If you are accessing Powerlink for the first time, you will need to apply for access and obtain a user name and password. Content Services for SAP Portal Repository Manager Documentation suite Title Description Target role Content Services for SAP Portal Repository Manager Release Notes Provides an overview of new and amended features, known bugs, limitations, miscellaneous technical notes, and documentation correctness and clarifications. Standard User, System Administrator 10 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

11 Preface Title Description Target role Content Services for SAP Portal Repository Manager Installation Guide Content Services for SAP Portal Repository Manager Administration Guide Provides the procedures for installing Repository Manager. Describes how to configure and administer Repository Manager. System Administrator System Administrator Note: Repository Manager extensively uses SAP NetWeaver s Knowledge Management component and repository framework. For information on performing advanced tasks with specific SAP components, refer to the following SAP resources: Knowledge Management component Knowledge Management section of the SAP Help Web site ( Repository framework Repository Framework Concepts section of the SAP Developer Network Web site ( SAP Portal SAP Portal section of the SAP Help Web site ( EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 11

12 Preface 12 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

13 Chapter 1 Introducing Content Services for SAP Repository Manager Overview Content Services for SAP Portal Repository Manager integrates the EMC Documentum content management system with the SAP NetWeaver platform. Repository Manager allows users to seamlessly access and exploit the capabilities of the EMC Documentum content management system from within SAP Portal Knowledge Management. Repository Manager is based on SAP NetWeaver s Repository Framework. Repository Manager allows users to: Access content stored in an EMC Documentum repository from within SAP Portal. Seamlessly leverage the functionalities of SAP Portal for content stored in EMC Documentum. The SAP Portal functionalities available for content stored in EMC Documentum integrate into the Knowledge Management (KM) functions, federated search, navigation, and so on. access EMC Documentum features within SAP Portal. The EMC Documentum functionalities available within SAP Portal include library services such as checkin, checkout, move, copy, and so on. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 13

14 Introducing Content Services for SAP Repository Manager Understanding the Repository Manager architecture Figure 1. Content Services for SAP Repository Manager architecture Content Services for SAP Portal Repository Manager is EMC Documentum s implementations of SAP NetWeaver s Repository Manager interface. EMC Documentum s implementations of SAP NetWeaver interfaces can be broadly classified as follows: Namespace management related implementation This implementation performs the following tasks: Identifies the type of a resource. Retrieves resources. Handles basic document management operations. Property management related implementation This implementation performs the following tasks: Handles the read only property requests. Handles mutable properties. 14 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

15 Introducing Content Services for SAP Repository Manager Content management related implementation This implementation performs the following tasks: Displays the content of the given resource. Sets the content for a given resource. Fetches the content specific metadata (content length, content type, encoding, and so on). Sets the content specific metadata. Creates linear versions. Checks out a resource. Checks in a resource. Lock management related implementation This implementation performs the following tasks: Handles concurrent accesses to resources in a repository. Locks and unlocks a resource. Clears a lock on a resource. Understanding SAP and Repository Manager terms This section presents terms and their definitions, as used in this guide. Table 1. Terms and definitions Term Content Services for SAP Portal Repository Manager Definition Application that integrates the EMC Documentum content management system with SAP NetWeaver. Repository Manager is based on SAP s repository framework. Repository Manager allows users to seamlessly access and exploit the capabilities of the EMC Documentum content management system from within SAP Portal. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 15

16 Introducing Content Services for SAP Repository Manager Term Repository DCTMNamespaceManager DCTMPropertyManager DCTMContentManager Definition Any information source such as a file system, content management system, and so on. EMC Documentum s implementation of SAP NetWeaver s IMutableNamespace Manager interface. This implementation performs the following tasks: Identifies the type of a resource. Retrieves resources. Handles basic document management operations. EMC Documentum s implementation of SAP NetWeaver s IMutablePropertyManager interface. This implementation performs the following tasks: Handles the read only property requests. Handles mutable properties. EMC Documentum s implementation of SAP NetWeaver s IMutableContentManager interface. This implementation performs the following tasks: Displays the content of the given resource. Sets the content for a given resource. Fetches the content specific metadata (content length, content type, encoding, and so on). Sets the content specific metadata. Creates linear versions. Checks out a resource. Checks in a resource. 16 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

17 Introducing Content Services for SAP Repository Manager Term DCTMLockManager DFC Services Container SAP NetWeaver SAP Portal SAP Web AS Repository Framework Definition EMC Documentum s implementation of SAP NetWeaver s IMutableLockManager interface. This implementation performs the following tasks: Handles concurrent accesses to resources in a repository. Locks and unlocks a resource. Clears a lock on a resource. A common component required to host helper services for all DFC based application in an SAP Portal on UNIX platforms. An open integration and application platform that integrates people, information, and processes. SAP NetWeaver powers mysap Business Suite, SAP xapps, partner solutions, and custom built applications. A scalable, robust portal, with an open architecture capable of integrating unlimited content. Portal content is designed to retrieve information from varied information sources such as Web sites, groupware applications, legacy systems, enterprise applications, databases, and document directories. An evolution of the component SAP_BASIS. Using the Web as a technology platform for SAP applications, you can develop Web applications in Java, in addition to the existing BASIS functions. An extensible framework provided by SAP that offers unified access to applications. Repository Framework (RF) allows applications to access objects provided by various information sources. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 17

18 Introducing Content Services for SAP Repository Manager Term SAP Knowledge Management TREX EMC Documentum repository custom type and property User Mapping SAP System Landscape Definition Comprises the following SAP subcomponents: Content Management (CM) Search and Classification (TREX) The Search and Classification component of SAP NetWeaver. TREX provides SAP applications with services for searching and classifying in both structured and unstructured data. Refers to the following: All EMC Documentum resource types and their associated properties, which are extended from out of the box resource types shipped with EMC Documentum Content Server. All RM related resource types and their associated properties that are used to implement specific features; for example, resource types and associated properties that are used to implement virtual documents and renditions.these resource types and associated properties are not shipped with EMC Documentum Content Server. A feature that provides log in information for users on third party systems. This log on information can simply be user ID and password and additionally information like NT Domain and language. Enterprise IT system infrastructure managed by SAP, containing various IT applications, objects, and aliases. Through a well defined system landscape, SAP maintains connectivity to various backend applications and information sources. 18 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

19 Introducing Content Services for SAP Repository Manager Term EMC Documentum Content Server DFC LDAP DMCL Definition Content Server is the foundation of Documentum s content management system. Content Server is the core functionality that allows users to create, capture, manage, deliver, and archive enterprise content. The functionality and features of Content Server provide content and process management services, security for the content and metadata in the repository, and distributed services. Documentum Foundation Classes. A key part of the EMC Documentum software platform. From the EMC Documentum functionality point of view, DFC lies between EMC Documentum Content Server and EMC Documentum clients. DFC is Java based. Acronym for Lightweight Directory Access Protocol. Industry standard networking protocol that queries and modifies directory services. Documentum Client Library. Manages communication between clients and EMC Documentum Content Server. Contains a library of API calls that are used by clients for execution on the EMC Documentum Content server. All client requests to the EMC Documentum Content Server go through the DMCL. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 19

20 Introducing Content Services for SAP Repository Manager 20 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

21 Chapter 2 Installing Content Services for SAP Portal Repository Manager Overview This chapter describes the installation process for Repository Manager. Installing Repository Manager consists of the following high level tasks; each of these tasks, in turn, are procedures containing several low level tasks: 1. Installation prerequisites, page Preinstallation tasks, page Installing Repository Manager, page Significant installation related system files and folders, page Postinstallation configuration, page 38) Installation prerequisites General prerequisites The person installing Repository Manager 6.0 should have administrative experience with the software products listed in the Software requirements section of the Content Services for SAP Portal Repository Manager Release Notes. Note: Unless the person installing the product has the prerequisite experience, EMC Documentum recommends that you do not perform installations using only manuals as a guide. EMC Documentum Support can only assist with systems which were installed by qualified persons following the specific instructions outlined in the documentation. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 21

22 Installing Content Services for SAP Portal Repository Manager Software prerequisites Repository Manager depends on specific versions of Documentum and third party products. Please refer to the Software Requirements section of the Content Services for SAP Portal Repository Manager Release Notes for detailed information about software prerequisites for Repository Manager. Preinstallation tasks Overview This section covers the following topics: Common preinstallation tasks, page 22 Windows specific preinstallation tasks, page 27 UNIX specific preinstallation tasks, page 28 Common preinstallation tasks Overview Before installing Repository Manager 6.0 in both Windows and UNIX, you must perform the following tasks : Obtaining the latest copy of the product from the EMC Documentum Download Center, page 23 Ensuring that the EMC Documentum repository is working, page 23 Configuring EMC Documentum Content Server, page 24 Ensuring that Java is installed, page 24 Configuring client side setup, page 24 Verifying DFC installation, page 25 Verifying the SAP NetWeaver installation, page 25 Configuring LDAP settings for EMC Documentum Content Server and SAP NetWeaver, page 26 Copying logging related files, page EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

23 Installing Content Services for SAP Portal Repository Manager Obtaining the latest copy of the product from the EMC Documentum Download Center To ensure that you install the current version of this product, visit the EMC Documentum Download Center ( and review the product versions available for your platform. Download the installer archive (Documentum_Repository_Manager_<versionnumber>_<operating system>.zip/tar) of the current release of Repository Manager to a local system. Extract the contents of the installer archive to a temporary directory. Depending on the downloaded archive, the extracted contents could comprise one of the following lists of files: Documentum_Repository_Manager_<version number>_windows.zip: com.documentum.ei.eprm.manager.dctmrepositorymanager.par DCTMRepositoryManager.sca DCTMRMExtractor.zip log4j_rm.properties DctmRMExtendedConfiguration.xml Documentum_Repository_Manager_<version number>_unix.tar: com.documentum.ei.eprm.manager.dctmrepositorymanager.par DCTMRepositoryManager.sca DCTMRMExtractor.zip dmcl.war dfcbase_clt.jar log4j_rm.properties DctmRMExtendedConfiguration.xml Ensuring that the EMC Documentum repository is working The repository should be fully functional before you install Repository Manager. Repository Manager writes configuration objects into the designated repository during the install. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 23

24 Installing Content Services for SAP Portal Repository Manager Configuring EMC Documentum Content Server Ensure that the following parameters are included in server.ini: concurrent_sessions The concurrent_sessions key controls the number of connections the server can handle concurrently. This number must take into account not only the number of users who will be accessing EMC Documentum from SAP Portal concurrently, but also what kinds of operations those users will be executing. The default value is 100. Note: The value of the max_session_count key (refer to Configuring client side setup, page 24) must always be lesser than the value of concurrent_sessions. login_ticket_timeout This setting defines the length of time for which a login ticket is valid. The value is interpreted in minutes. By default, the attribute is set to 5 minutes. ticket_multiplier This setting determines the number of login tickets allocated in shared memory. The number of tickets allocated by the server is computed as follows: #tickets = concurrent_sessions * ticket_multiplier The default value is 10. Note: For more information on the parameters discussed in this section, refer to Documentum Content Server Administrator s Guide and EMC Documentum Content Server s Object Reference Manual. Ensuring that Java is installed Ensure that J2SE, version 1.4.2_x is installed. Be sure to set the JAVA_HOME system variable to the JDK installation directory. Configuring client side setup On the system where DFC and SAP NetWeaver are installed, configure the setup as follows: Ensure that EMC Documentum Content Server is accessible through a connection broker; the name of the connection broker should be defined in the dmcl.ini file. 24 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

25 Installing Content Services for SAP Portal Repository Manager Ensure that the following parameters are included in the dmcl.ini file: connect_pooling_enabled Determines whether connection pooling is enabled. The default value is F: not enabled. Set the value to T to enable connection pooling. connect_recycle_interval This setting ensures that a limit is set on the number of times a repository session can be reused before it is destroyed. The limit prevents a single session process from becoming too big. By default, the connect_recycle_interval key is set to 300 seconds. max_session_count This setting determines the maximum number of sessions a single user can establish. The default value is 10. Note: EMC Documentum recommends that the max_session_count value always be less than the value of the concurrent_sessions key (refer to Configuring EMC Documentum Content Server, page 24). Note: For more information on the parameters discussed in this section, refer to Documentum Content Server Administrator s Guide and EMC Documentum Content Server s Object Reference Manual. Verifying DFC installation Corresponding to the EMC Documentum Content Server version, ensure that DFC SP4 (or higher) is installed on the system on which SAP Web AS is installed. Verify that all required system variables have been correctly configured; for information on configuring DFC related system variables, refer to Documentum Foundation Classes (DFC) Installation Guide. Verifying the SAP NetWeaver installation Ensure that SAP NetWeaver 04 SR1 is installed and functional. For the Knowledge Management Collaboration module of SAP NetWeaver, be sure to apply Patch 3; this patch is required for TREX, NetWeaver s Search and Classification component, to function correctly. Note: For TREX on SAP NetWeaver 04 SPS14, you do not need to apply the patch. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 25

26 Installing Content Services for SAP Portal Repository Manager To verify the version of an installed NetWeaver application, do the following: Using SAP Portal, connect to the SAP NetWeaver server on which you intend to deploy Repository Manager. Note: You must log in to SAP NetWeaver as a system administrator. Browse to System Administration > Support > Version. In the content area, the software versions of J2EE Engine, Portal, and KnowledgeManagementCollaboration are displayed. Note: To deploy Repository Manager in SAP NetWeaver, ensure that you have system administration privileges in SAP NetWeaver. To verify if you have system administration privileges: 1. Log in to SAP Portal. 2. Ensure that the System Administration tab is displayed in the top level navigation bar. Configuring LDAP settings for EMC Documentum Content Server and SAP NetWeaver If you want EMC Documentum Content Server and SAP NetWeaver to use a common user base, you must configure these applications so that they point to the same LDAP directory server. For information on using EMC Documentum Content Server with an LDAP directory server, refer to the How the directory server and a repository are synchronized section of the Content Server Administrator s Guide. For information on using SAP NetWeaver with an LDAP directory server, refer to the System Landscape with LDAP Directory section of the SAP Help Web site ( Updating EMC Documentum custom repository properties Since the custom repository properties have been updated with the 5.3 SP4 release, you should undeploy any EMC Documentum repository resource types and associated properties that were extracted using an earlier version of RM. For information on undeploying EMC Documentum custom repository properties from SAP Portal, refer to Undeploying custom repository properties, page 72 and Undeploying custom repository resource bundles, page EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

27 Installing Content Services for SAP Portal Repository Manager Copying logging related files Copy the log4j_rm.properties file that you extracted previously (refer to Obtaining the latest copy of the product from the EMC Documentum Download Center, page 23) to the following location: In Windows: <DFC installation directory>\config In UNIX: <DFC installation directory>/config Windows specific preinstallation tasks Configuring SAP NetWeaver Note: If you have an existing installation of Content Services for SAP Portal Repository Manager, you need not perform the tasks described in this section. Configure SAP NetWeaver as follows: 1. In the system where SAP NetWeaver is installed, run the configtool.bat file available in the following directory: <SAP NetWeaver installation directory>\<j2eeinstance>\jc00\j2ee\configtool. 2. Use the SAP Web AS configuration tool to configure the following settings: Type the following value in the Java parameters field: Djava.library.path=<DFC installation directory>\shared Note: The value that you provide for the Djava.library.path parameter should not contain spaces. For example, if the parameter value is C:\Program Files\Documentum\Shared, you should eliminate the space and type the value as follows: C:\progra~1\documentum\shared. Otherwise, SAP Web AS will not start. Drm.log4j.configuration.filename=<DFC installationdirectory>\config\log4j_rm.properties This configuration ensures that Repository Manager uses a separate log file, instead of the default log4j.properties file. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 27

28 Installing Content Services for SAP Portal Repository Manager Type the following values in the Classpath field: <DFC installation directory>/config <DFC installation directory>/shared/dfcbase.jar UNIX specific preinstallation tasks Overview Installing Repository Manager in UNIX requires special consideration. This section contains the following topics: Preparing Tomcat, page 28 Preparing Sun Java System Application Server, page 30 Configuring SAP NetWeaver, page 31 Preparing Tomcat Overview This section contains the following topics: Installing Tomcat, page 28 Configuring Tomcat, page 29 Installing Tomcat On UNIX systems, a separate Tomcat installation is required to host DFC library services. You should install Tomcat ; this Tomcat installation is then configured to work specifically with Repository Manager. Note: On UNIX systems, install Tomcat on the same host as SAP Web AS. 28 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

29 Installing Content Services for SAP Portal Repository Manager In UNIX, Tomcat needs to be installed by SAP NetWeaver s installation owner. Typically, the user ID of this installation owner is <SID>adm, where SID is the three character system name required by SAP. Example 2 1. The user ID could be pe1adm, where pe1 fulfills SAP s requirement for a three character SID; the first 2 characters of the SID must be a letter of the alphabet, while the last character must be a number. This is an SAP requirement. By default, Apache Tomcat will use port 8080 for the HTTP connector port. On the other hand, the default port used by the Tomcat installed with EMC Documentum Content Server installation is 9080; you should not confuse the two. For detailed installation, configuration, and administration instructions, refer to the documentation available in Tomcat s Web site ( Configuring Tomcat Configure Tomcat as follows: 1. The downloaded installation package of Repository Manager for UNIX contains a file named dmcl.war. Copy the dmcl.war file to the following directory: <Tomcat installation directory>/webapps. 2. Ensure that the catalina.sh file (available in <Tomcat installation directory>/bin) contains the following parameters: DOCUMENTUM_SHARED=<DFC installation root directory> DOCUMENTUM=<Documentum user root directory> DMCL_CONFIG=$DOCUMENTUM/dmcl.ini export DMCL_CONFIG CLASSPATH="$CLASSPATH":$DOCUMENTUM_SHARED/dfc/dfcbase. jar:$documentum_shared/dfc/dfc.jar:$documentum_shared/config 3. Restart Tomcat. Tomcat picks up the WAR file and unpacks it to the same folder. Note: You can monitor the progress of events using the following URL: port number>/manager/html. 4. Verify the deployment of the dmcl.war file. Do the following: Using a browser on the SAP Portal host, access the following URL: EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 29

30 Installing Content Services for SAP Portal Repository Manager Verify the displayed information. If the deployment is successful, the following information appears: Content Services for SAP Portal (DMCL HTTP Servlet), <IVRC_version_number> DMCL version=<dmcl_version_number> <operating_system> Preparing Sun Java System Application Server 1. The installer archive of Repository Manager for UNIX contains a file named dmcl.war; download the archive and extract the contents to a temporary directory (refer to Obtaining the latest copy of the product from the EMC Documentum Download Center, page 23). 2. Log in to the Solaris system where Sun Java System Application Server is installed, and do the following: 1. Set the following environment variables in Solaris. Environment variable Description Required values DOCUMENTUM DOCUMENTUM_ SHARED LD_LIBRARY_PATH The full path of the DFC user root (and Content Server root, if it is installed on the application server host). The full path to the DFC program root. Solaris shared library path. 2. Open the server.policy file located here: Any directory in the installation owner s environment. Any directory in the installation owner s environment. Any directory in the installation owner s environment.for example, ${DOCUMENTUM_ SHARED}/dfc <Application_Server_Installation_Directory> > <Application_Server_Domain> > <Application_Server_Instance> > config 3. Add the following code snippet to the file: //permission for Documentum Repository Manager dmcl grant { permission java.util.propertypermission "dmcl_http.servletbasepath", "read,write"; }; 30 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

31 Installing Content Services for SAP Portal Repository Manager 3. Launch the Sun Java System Application Server administration console. 4. Browse to App Server Instances > <Application_Server_Instance>. The Application_Server_Instance page appears. 5. In the right pane, navigate to JVM Settings > Path Settings. 6. In the Classpath Suffix field, add dfcbase.jar. For example, /opt/documentum/dfc/dfcbase.jar. 7. Browse to App Server Instances > <Application_Server_Instance> > Applications > Web Apps. 8. Click Deploy. The Application_Server_Instance: Upload WAR File page appears. 9. Click the Browse button, and navigate to the local directory where the dmcl.war file is located. 10. Select dmcl.war and click OK. The Application_Server_Instance: Applications: Web: Deploy page appears. 11. Click OK. The dmcl web application is deployed. 12. Restart Sun Java System Application Server. 13. Verify the deployment of the dmcl.war file. Do the following: Using a browser on the SAP Portal host, access the following URL: Verify the displayed information. If the deployment is successful, the following information appears: Content Services for SAP Portal (DMCL HTTP Servlet), <IVRC_version_number> DMCL version=<dmcl_version_number> <operating_system> Configuring SAP NetWeaver Configure SAP NetWeaver as follows: 1. The downloaded installation package of Repository Manager for UNIX contains a file named dfcbase_clt.jar. In the system where SAP NetWeaver is installed, copy the dfcbase_clt.jar to ${DOCUMENTUM_SHARED}/dfc. 2. Run the configtool.sh file available in the following directory: <SAP NetWeaver installation directory>/<j2ee instance>/jc00/j2ee/configtool EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 31

32 Installing Content Services for SAP Portal Repository Manager 3. In the left pane of the SAP Web AS configuration tool, browse to cluster data > instance_id<instance number> > server_id<server number>. 4. Click the General tab. 5. In the Java parameters field, type the following value: Drm.log4j.configuration.filename=<DFC installation directory>/ config/log4j_rm.properties This configuration ensures that Repository Manager uses a separate log file, instead of the default log4j.properties file. 6. In the Classpath field, type the following values: ${DOCUMENTUM_SHARED}/dfc/ dfcbase_clt.jar;${documentum}/config 7. By default, Tomcat is installed on port If you have installed Tomcat on any other port, type the following value in the Java parameters field: Ddmcl.port=<Tomcat port number>. 8. EMC Documentum recommends that you install both the application server and SAP Web AS on the same UNIX system. If Tomcat is installed on a different system, perform the following tasks: 1. In the Java parameters field of the SAP Web AS configuration tool, type the following value: Ddmcl.server=<name or IP address of system>. 2. In the system where Tomcat is installed, browse to <Application_server_ installation_directory>/webapps/dmcl/web INF. 3. Edit the web.xml file available in this folder as follows: In the allowedhosts section, type the name or IP address of the system on which SAP NetWeaver is installed. Note: Be sure to type only the name or IP address of a trusted host. Installing Repository Manager Overview EMC Documentum supports the installation of Repository Manager using various SAP deployment tools. The following SAP deployment tools are supported: Software Deployment Manager (SDM) Visual Administrator Administration Console 32 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

33 Installing Content Services for SAP Portal Repository Manager Note: EMC Documentum recommends that you use SDM as the preferred SAP deployment tool when installing Repository Manager in SAP Portal. However, EMC Documentum also supports the installation of Repository Manager using Visual Administrator and Administration Console. EMC Documentum recommends that you perform both the installation and uninstallation of Repository Manager using the same SAP deployment tool. For example, if you installed Repository Manager using Visual Administrator, EMC Documentum recommends that you also perform the uninstallation using Visual Administrator. This section contains the following topics: Installing Repository Manager using SDM, page 33 Installing Repository Manager using Visual Administrator, page 34 Installing Repository Manager using Administration Console, page 35 Installing Repository Manager using SDM To install Repository Manager using SDM: 1. Perform the tasks described in Obtaining the latest copy of the product from the EMC Documentum Download Center, page On the host where you want to install Repository Manager, log in as the root user. 3. Do one of the following: In Windows: Browse to <SAP NetWeaver installation directory>\<j2eeinstance>\jc00\sdm\program and double click RemoteGui.bat. In UNIX: Browse to <SAP NetWeaver installation directory>/<j2ee instance>/jc00/sdm/ program and execute RemoteGui.sh. The SAP Software Deployment Manager GUI window appears. 4. From the menu, choose SDM GUI > Login. 5. In the window that appears, type your authentication information and click Login. 6. Click the Deployment tab. 7. Click the Local File Browser button, browse to and select DCTMRepositoryManager. sca, and click Choose. 8. Click Next. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 33

34 Installing Content Services for SAP Portal Repository Manager 9. In the Target Systems and Deployments section of the window, select SapJ2EEEngine. 10. If you re installing a newer version of Repository Manager, do the following: 1. In the Deployment Configuration section of the window, click the Up arrow. 2. In the Settings for Updating SCAs/SDAs section, select the Update deployed SCAs/SDAs that have lower component version radio button. 11. Click Next. 12. Click Start Deployment. The status bar indicates the progress of the deployment. 13. When the deployment is complete, click Confirm. Installing Repository Manager using Visual Administrator To install Repository Manager using Visual Administrator: 1. Perform the tasks described in Obtaining the latest copy of the product from the EMC Documentum Download Center, page On the host where you want to install Repository Manager, log in as the root user. 3. In the system where SAP NetWeaver is installed, depending on the operating system, run the go.bat file available in one of the following locations: In Windows: <SAP NetWeaver installation directory>\<j2eeinstance>\ JC00\j2ee\admin In UNIX: <SAP NetWeaver installation directory>/<j2eeinstance>/ JC00/j2ee/admin The Connect to SAP J2EE Engine dialog box appears. 4. Select Default and click Connect. The Login dialog box appears. 5. Enter your login credentials and click Connect. The Visual Administrator interface appears. 6. In the left pane, browse to SID > <server instance> > Services > Deploy. 7. Click the Applications tab in the lower part of the center pane. 8. Click Deploy & Start. 34 EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

35 Installing Content Services for SAP Portal Repository Manager The Deploy & Start dialog box appears. 9. In the File field, browse to the DCTMRepositoryManager.sca file that you extracted previously (refer to Obtaining the latest copy of the product from the EMC Documentum Download Center, page 23). Click OK. 10. An warning message appears indicating which temporary directory is used for extracting the contents of the file. Review the message and click OK. Note: This is just an informational message and does not affect the functionality of the product. 11. A warning message appears indicating that the application does not have any J2EE modules. Review the message and click OK. Note: This is just an informational message and does not affect the functionality of the product. 12. The Deploy Dialog dialog box appears. In this dialog box, the Application overwriting check option is selected by default. This allows Visual Administrator to overwrite previously installed versions of Repository Manager. To proceed, click OK. 13. The progress bar in the bottom right corner of the interface displays the status of the installation. When the progress bar displays 100%, the installation is complete. Note: Verify if the installation is successful; in the Deployed Components section of the center pane in Visual Administrator, locate the following entry for Repository Manager: sap.com/com.documentum.ei.eprm.manager.dctmrepositorymanager. This entry indicates that the Repository Manager installation is successful. Installing Repository Manager using Administration Console To install Repository Manager using Administration Console: 1. Perform the tasks described in Obtaining the latest copy of the product from the EMC Documentum Download Center, page Using SAP Portal, connect to the SAP NetWeaver server on which you would like to deploy Repository Manager. Note: You must log in to SAP Portal as a system administrator. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 35

36 Installing Content Services for SAP Portal Repository Manager 3. Browse to System Administration > Support > Portal Runtime > Administration Console > Archive Uploader. 4. In the Archive Uploader section, use the Browse button to browse to the portal archive file (com.documentum.ei.eprm.manager.dctmrepositorymanager.par) that you extracted previously (refer to Obtaining the latest copy of the product from the EMC Documentum Download Center, page 23). 5. Click Upload. Note: If you have previously installed the com.documentum.ei.eprm.manager. DCTMRepositoryManager.par file, but would like to update the installation with the latest version, do the following: 1. Delete the existing com.documentum.ei.eprm.manager.dctmrepositorymanager. par file. Do the following: 2. Browse to System Administration > Support > Portal Runtime > Administration Console > Archive Uploader. 3. In the Archive Remover section of the content area, select com.documentum.ei. eprm.manager.dctmrepositorymanager.par from the drop down list. Click Clean. 4. An information message appears asking you to confirm the action. Click OK. 5. Upload the latest version of com.documentum.ei.eprm.manager. DCTMRepositoryManager.par file (refer to Installing Repository Manager using Administration Console, page 35). Significant installation related system files and folders Overview The following are some of the significant installation related files and folders available on the system where SAP NetWeaver is installed: log4j_rm.properties, page 37 com.documentum.ei.eprm.manager.dctmrepositorymanager, page EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide

37 Installing Content Services for SAP Portal Repository Manager log4j_rm.properties The log4j_rm.properties file is a part of the installer archive of Repository Manager (refer to Obtaining the latest copy of the product from the EMC Documentum Download Center, page 23). You should configure the SAP Web AS configuration tool to ensure that, for logging purposes, Repository Manager uses the log4j_rm.properties file, instead of EMC Documentum s default logging file (log4j.properties); refer to Configuring SAP NetWeaver, page 27 (Windows) and Configuring SAP NetWeaver, page 31 (UNIX). All logging details are contained in the log4j_rm.properties file available in the following directory: In Windows: <DFC installation directory>\config In UNIX: <DFC installation directory>/config SAP Web AS is aware of this location because the directory path is referenced in the Classpath field of the SAP Web AS configuration tool; refer to Configuring SAP NetWeaver, page 27 (Windows) and Configuring SAP NetWeaver, page 31 (UNIX). For information on working with the log4j_rm.properties file, refer to the Working with Repository Manager related Logging section of Content Services for SAP Portal Repository Manager Administration Guide. com.documentum.ei.eprm.manager. DCTMRepositoryManager After Repository Manager is deployed in SAP NetWeaver, the contents of the Repository Manager portal archive file (com.documentum.ei.eprm. manager.dctmrepositorymanager.par) are unpacked to a folder named com.documentum.ei.eprm.manager.dctmrepositorymanager. The name of this folder is always the name of the<name of portal archive>.par file. Note: The contents are unpacked on to the system where SAP NetWeaver is installed. EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide 37

38 Installing Content Services for SAP Portal Repository Manager The <name of portal archive file> folder is located in the following directory: In Windows: <SAP NetWeaver installation directory>\<j2eeinstance>\jc00\j2ee\cluster\<server instance>\apps\sap.com\irj\servlet_ jsp\irj\root\web INF\portal\portalapps In UNIX: <SAP NetWeaver installation directory>/<j2ee instance>/jc00/j2ee/cluster/<serverinstance>/apps/sap.com/irj/servlet_jsp/irj/root/web INF/portal/portalapps Postinstallation configuration Overview This section contains the following topics: Configuring SAP NetWeaver, page 38 Configuring Repository Manager instances, page 41 Working with custom repository properties, page 44 Configuring SAP NetWeaver Overview This section contains the following topics: Copying DFC related JAR files, page 38 Copying Repository Manager related images, page 40 Copying DFC related JAR files This section contains the following topics: In Windows, page 39 In UNIX, page EMC Documentum Content Services for SAP Repository Manager Version 6.0 Installation Guide