Download as pdf or txt
Download as pdf or txt
You are on page 1of 184

OpenText™ Extended ECM for SAP®

Solutions

Installation and Upgrade Guide

This guide describes how to plan the installation, how to install


the SAP and the Content Server components of OpenText
Extended ECM for SAP Solutions and how to set up the
communication between SAP and Content Server. It also
contains upgrade information.

ERLK160200-00-IGD-EN-05
OpenText™ Extended ECM for SAP® Solutions
Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Rev.: 29. Nov. 2017
This documentation has been created for software version 16.2.
It is also valid for subsequent software versions as long as no new document version is shipped with the product or is
published at https://knowledge.opentext.com.

Open Text Corporation

275 Frank Tompa Drive, Waterloo, Ontario, Canada, N2L 0A1

Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Support: https://support.opentext.com
For more information, visit https://www.opentext.com

Copyright © 2017 Open Text. All Rights Reserved.


Trademarks owned by Open Text.

Disclaimer

No Warranties and Limitation of Liability

Every effort has been made to ensure the accuracy of the features and techniques presented in this publication. However,
Open Text Corporation and its affiliates accept no responsibility and offer no warranty whether expressed or implied, for the
accuracy of this publication.
Table of Contents
1 What is OpenText Extended ECM for SAP Solutions ............ 7
1.1 Related documentation ...................................................................... 7

Part 1 Installing Extended ECM for SAP Solutions 11

2 Prerequisites ............................................................................ 13
2.1 Required knowledge ........................................................................ 13
2.2 SAP system requirements ............................................................... 13
2.3 Content Server system requirements ................................................ 16
2.4 SAP Add-On Installation Tool (SAINT) .............................................. 17
2.5 Finding version information for Extended ECM for SAP Solutions
relevant system components ............................................................ 18

3 Installing Extended ECM for SAP Solutions ......................... 21


3.1 Installation sequence for Extended ECM for SAP Solutions ............... 21

4 Installing the SAP package ..................................................... 23

5 Generating roles ...................................................................... 25

6 Installing language packages in the SAP system ................ 27

7 Installing the Content Server modules .................................. 29


7.1 Installation procedure on Content Server .......................................... 29
7.2 Installing Content Server and modules files ....................................... 29
7.3 Installing the Content Server modules .............................................. 32

8 Installing language packs on Content Server ....................... 33

9 Deploying Extended ECM Web Services ............................... 35


9.1 Deploying Extended ECM Web Services into the application server ... 35
9.2 Deploying Content Web Services ..................................................... 37
9.3 Configuring host and port for Content Server in Tomcat ..................... 38

Part 2 Upgrading Extended ECM for SAP Solutions 39

10 Upgrade scenarios .................................................................. 41


10.1 Supported combinations .................................................................. 42

11 General recommendations for the upgrade .......................... 45

12 Upgrading from Extended ECM for SAP Solutions 16 to


16.2 ............................................................................................ 47
12.1 Checklist for upgrade from Extended ECM for SAP Solutions 16 to
16.2 ............................................................................................... 47

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide iii
ERLK160200-00-IGD-EN-05
Table of Contents

12.2 Upgrading the database schema ...................................................... 59


12.3 Upgrading to Extended ECM for SAP Solutions in the SAP system .... 60

13 Upgrading from ECMLink 10.5.1 with Content Server 10.5


to Extended ECM for SAP Solutions 16.2 ............................. 61
13.1 Checklist for upgrade from ECMLink 10.5.1 with Content
Server 10.5 SP1 to Extended ECM for SAP Solutions 16.2 ................ 61
13.2 Upgrading the database schema ...................................................... 74
13.3 Upgrading to Extended ECM for SAP Solutions in the SAP system .... 75

14 Upgrading from ECMLink 10.0.3, 10.0.4, or 10.5.0 ................ 77

15 Upgrading from ECMLink 9.8.x, 10.0, or 10.0 SP1 or SP2 ... 79

16 Upgrading from versions prior to 9.8 .................................... 81

Part 3 Post-installation and post-upgrade tasks 83

17 Performing general post-installation tasks in SAP .............. 85


17.1 Using the IMG function .................................................................... 85
17.2 Assigning SAP roles ........................................................................ 88

18 Performing post-installation tasks for SAP ERP 6.0, SAP


CRM 7.0, and SAP SRM 7.0 ..................................................... 91
18.1 Exporting the SAP PSE certificate for the SAP authentication
handler ........................................................................................... 91
18.2 Activating the SSO HTTP service ..................................................... 94
18.3 Creating logical ports in the SAP system .......................................... 95
18.3.1 Creating logical ports for SAP Basis 7.0 ............................................ 95
18.3.2 Creating logical ports for SAP Basis 7.01 ........................................ 102
18.3.3 Creating logical ports for SAP Basis 7.31 ........................................ 106
18.3.4 Creating logical ports for SAP Basis 7.51 ........................................ 110
18.4 Configuring the Service Provider Interface service ........................... 113
18.5 Maintaining Extended ECM connections ......................................... 114
18.6 Improving data security for impersonation connections .................... 118
18.7 Importing the Content Server SSL certificate ................................... 119

19 Performing post-installation or post-upgrade tasks in


Content Server ....................................................................... 121
19.1 Importing root certificates for Secure Sockets Layer (SSL)
connections .................................................................................. 121
19.2 Connecting SAP as the business application ................................... 122
19.3 Configuring the storage provider .................................................... 125
19.4 Managing users ............................................................................ 125
19.5 Preparing document declaration ..................................................... 126
19.5.1 Creating an Enterprise Library application ....................................... 126

iv OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Table of Contents

19.5.2 Creating a Records Management classification (optional) ................ 129


19.5.3 Importing folder and item type ........................................................ 129
19.5.4 Setting up the authorization for records ........................................... 131
19.5.5 Creating system categories in Content Server ................................. 132
19.6 For SAP CRM and SRM: Configuring security settings .................... 133

20 Verifying the installation ....................................................... 135


20.1 Analyzing the SAP system ............................................................. 135
20.1.1 Understanding the SAP Diagnostic Program ................................... 135
20.1.2 Understanding the details of the Diagnostic Program ....................... 136
20.1.3 Understanding the Configuration Report ......................................... 141

Part 4 Miscellaneous 143

21 Installing Content Server patches using the cluster


management tool ................................................................... 145

22 Performing additional optional tasks .................................. 147


22.1 Checking the appearance of the SAP integration ............................. 147
22.2 Adding your own logo to Content Server Smart View ....................... 150
22.3 Customizing the integration into SAP GUI via Generic Object
Services ....................................................................................... 152
22.3.1 Customizing the Generic Object Services (SAP GUI) ....................... 152
22.3.2 Select items to be displayed in Business Content window ................ 154
22.3.3 Customizing the context menu of the Business Content window ....... 155
22.3.3.1 Customizing the Business Content window context menu with
Content Server menu entries ......................................................... 155
22.3.3.2 Adding custom functionality to the Business Content window
context menu ................................................................................ 157
22.3.4 Providing Drag-and-drop functionality for the Business Content
window ......................................................................................... 157
22.3.5 Enabling the integration widget in the Business Content window ...... 157
22.3.6 Configuring Microsoft IIS to Return Meaningful REST API Error
Messages ..................................................................................... 158
22.3.7 Maintaining Content Server subtypes as copy/move target in the
Business Content window .............................................................. 159
22.3.8 Providing access to local folders for the Business Content window ... 160
22.3.9 Providing thumbnails for business workspace documents in the
Business Content window .............................................................. 161
22.3.10 Integrating Viewers in the Business Content window ....................... 161
22.3.11 Customizing MIME types for preview .............................................. 164
22.3.12 Customizing the GOS Attachment list for Records Management ...... 165
22.4 Viewing the old configuration in SAP .............................................. 166
22.5 Configuring Single Sign-on for Content Server ................................ 167
22.6 Configuring Imaging viewers .......................................................... 168

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide v
ERLK160200-00-IGD-EN-05
Table of Contents

23 Preparing a checklist for the customizing team ................. 171

24 Transporting Extended ECM for SAP Solutions Content


Server configuration and templates .................................... 173
24.1 Transporting the Connected Workspaces configuration ................... 173
24.1.1 Importing the configuration ............................................................ 174
24.2 Transporting categories, classifications and workspace templates .... 176

GLS Glossary 179

vi OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 1
What is OpenText Extended ECM for SAP Solutions

OpenText Extended ECM for SAP Solutions is a combination of Content Server


modules, web services and an SAP package, with which you can integrate Content
Server functionality into SAP business processes. This includes functionality for
document and records management, archiving, workflow, and collaboration.

Business A business workspace in Content Server contains content that is relevant for a business
workspaces, object. From Content Server side, users can easily view the data of this business
cases and
binders
object. From the business application, users can access Content Server items in the
business workspace without leaving their system. To make full use of the Content
Server functionality, not only business workspaces but also cases and binders can be
configured for Extended ECM for SAP Solutions.

Business In addition to the content that is stored in a business workspace for a business object,
attachments users can connect additional documents as business attachments to a business object.

Business rela- Extended ECM for SAP Solutions provides tools to illustrate a relationship between
tionships business workspaces. For example, a hierarchical relationship between business
workspaces can be displayed in a sidebar widget of a business workspace.

1.1 Related documentation


Important
OpenText strongly recommends that you read OpenText Extended ECM for
SAP Solutions - Overview Guide (ERLK-GGD) to make you familiar with
architectural aspects and business scenarios of Extended ECM for SAP
Solutions.

Product docu- The following documentation is available for Extended ECM for SAP Solutions
mentation respectively on OpenText My Support (https://knowledge.opentext.com/knowledge/
cs.dll/Open/https://knowledge.opentext.com/knowledge/llisapi.dll/Open/10194282):

OpenText Extended ECM for SAP Solutions - Overview Guide (ERLK-GGD)


The Overview Guide contains a short overview over the functions and features
of Extended ECM for SAP Solutions. It also explains the architecture and shows
different business scenarios of Extended ECM for SAP Solutions.
OpenText Extended ECM for SAP Solutions - Installation and Upgrade Guide (ERLK-IGD)
(this guide)
The Installation Guide describes the installation and upgrade of Extended ECM
for SAP Solutions up to the point where the connection between SAP and
Content Server is established.
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD)
The Customizing Guide describes how to customize SAP and configure Content
Server for Extended ECM for SAP Solutions functionality.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 7
ERLK160200-00-IGD-EN-05
Chapter 1 What is OpenText Extended ECM for SAP Solutions

OpenText Extended ECM for SAP Solutions - Administration Guide (ERLK-AGD)


The Administration Guide describes ongoing maintenance tasks.

OpenText Extended ECM for SAP Solutions - User Management and Access Control
Scenarios (ERLK-CUM)
This guide discusses user management and access control scenarios.

OpenText Extended ECM for SAP Solutions - User Guide (ERLK-UGD)


The User Guide describes how to use Extended ECM for SAP Solutions
functionality in both SAP and Content Server. This guide is also available as
online help.

OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Microsoft SQL Server (ERLK-IWS)
This specific Installation Guide describes the setup of one architecture scenario
for Extended ECM for SAP Solutions with Microsoft SQL Server as database.

OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Oracle Database (ERLK-IWO)
This specific Installation Guide describes the setup of one architecture scenario
for Extended ECM for SAP Solutions with Oracle as database.

OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with SAP HANA (ERLK-IWH)
This specific Installation Guide describes the setup of one architecture scenario
for Extended ECM for SAP Solutions with SAP HANA as database.

OpenText Extended ECM for SAP Solutions eBook


The eBook describes the key concepts and capabilities of Extended ECM for SAP
Solutions.
The OpenText Extended ECM for SAP Solutions eBook is available on OpenText
My Support (https://knowledge.opentext.com/knowledge/llisapi.dll/Open/
18208703).

Content Server Champion Toolkit


A variety of documents deals with deployment scenarios of Content Server as
well as Best Practices examples.
The Content Server Champion Toolkit documents are available on OpenText My
Support (https://knowledge.opentext.com/knowledge/llisapi.dll/open/19905386).

Release Notes The Release Notes describe the following aspects in detail:
• The software supported by the product
• Requirements
• Restrictions
• Important dependencies
• Last-minute changes regarding the documentation
• Manual IDs of the current documentation

The Release Notes are continually updated. The latest versions of the Extended ECM
for SAP Solutions Release Notes is available on OpenText My Support: Extended

8 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
1.1. Related documentation

ECM for SAP Solutions (https://knowledge.opentext.com/knowledge/llisapi.dll/


Open/67811874).

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 9
ERLK160200-00-IGD-EN-05
Part 1
Installing Extended ECM for SAP Solutions
Part 1 Installing Extended ECM for SAP Solutions

This guide covers the details of Extended ECM for SAP Solutions installation, the
Content Server module Connected Workspaces and the SAP Add-on.

For information on installing the other products or components, which are part of
OpenText Extended ECM for SAP Solutions, see the individual installation guides.
For information on supported hardware and software platforms, check the
OpenText Extended ECM for SAP Solutions Release Notes.

OpenText also recommends that you read one of the following comprehensive
installation instructions for certain scenarios which are available on OpenText My
Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/10194282):
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Microsoft SQL Server (ERLK-IWS)
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Oracle Database (ERLK-IWO)
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with SAP HANA (ERLK-IWH)
• “Prerequisites“ on page 13
• “Installing Extended ECM for SAP Solutions“ on page 21
• “Installing the SAP package“ on page 23
• “Generating roles“ on page 25
• “Installing language packages in the SAP system“ on page 27
• “Installing the Content Server modules“ on page 29
• “Installing language packs on Content Server“ on page 33
• “Deploying Extended ECM Web Services“ on page 35

12 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 2

Prerequisites

Extended ECM for SAP Solutions supports the following SAP products:

• SAP S/4 HANA


• SAP ERP 6.0
• SAP CRM 7.0

Note: Content Server integration widget is only supported for Business


Workspace UI Integration in SAP CRM.
CRM Requirement: CRM 7.0 Ehp 1.
OTDS Requirement: 10.5 or higher
• SAP SRM 7.0

2.1 Required knowledge


The following knowledge is required from the person dealing with the installation
as described in this document:

• In-depth knowledge of SAP administration tasks, in particular the SAP Add-On


Installation Tool (SAINT).
• In-depth knowledge of OpenText™ Content Server, OpenText™ Archive Center,
Records Management, User Management, and OpenText™ Directory Services.
• Basic knowledge of the operating system.

2.2 SAP system requirements


Check the following prerequisites for SAP prior to installation:

Archiving and Document Access for SAP Solutions


The component OTEXBAS of Archiving and Document Access for SAP Solutions
must be installed on your SAP system. Check the Release Notes for required
versions and dependencies. This component is provided on the Extended ECM
for SAP Solutions installation medium. For more information, see OpenText
Archiving and Document Access for SAP Solutions - Installation and Upgrade Guide
(ER-IGD)

SAP support packages


Check the latest version of the Release Notes on OpenText My Support for
required support packages for the SAP.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 13
ERLK160200-00-IGD-EN-05
Chapter 2 Prerequisites

Transport system
The SAP application transport system is installed, this means the jobs RDDPUTPP
and RDDIMPDP are set up in the correct clients and scheduled to run periodically
or event-triggered.

SAP notes
The following SAP notes must be applied:

SAP Note Required for


110910 Some language-dependent texts may not be displayed
correctly in the GUI.
884077 Log-on error from external systems to WAS 7.00 systems:
The external candidate's password contains at least one
lower case letter. In accordance with the rules, which were
valid up to and including WAS 6.40, the registration
application changes the passwords to capital letters.
However, as of WAS 7.00 (see SAP Note 862989), the
system can be set in a way that it distinguishes between
upper case and lower case letters in a password. In this
case, the log-on fails if the original password contains at
least one lower case letter.
1128338 CALL_BROWSER does not launch a new window to open
the URL, even when the NEW_WINDOW parameter is
passed to the function module. Instead, an existing window
is used to open the URL.
However, as of SAP Note 1177636, the behavior of
CALL_BROWSER is changed to allow also opening URLs
on other platforms than Microsoft Windows. In this case,
the settings of the MS Internet Explorer govern the URL
handling, i.e. whether a new window is opened.
1255948 Required for the declare functionality of the print lists.
1227752 Required to avoid known problems with the web services.
1122938
(SAP ERP 6.0 and
SAP_BASIS 14 or higher)
2238264 (SAP S/4 HANA) Several outbound web service proxies should be triggered.
In that process a program termination of type
STYLESHEET_GENERATION_FAILURE is raised.
1424747 Enables the transmission of SOAP error codes to identify
problems.
1267258 Unexpected error message No vendor specified when log-
on language is English.
822380 Required to avoid known problems with the SAP Add-On
(SAP 7.00) Installation Tool (SAINT).
Installation information -
OSS note
212876
(SAPCAR tool)

14 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
2.2. SAP system requirements

SAP Note Required for


1382711 Required when using SAP CRM Investigative Case
1379958 Management.
1613012
1160362 Required for licensing, thumbnails, and group mapping.
The profile parameters of your SAP systemict/
disable_cookie_urlencoding = 1 must be configured.

Patch levels

• Patch level for SAP ERP 6.0


The minimum requirement for software components SAP_BASIS and
SAP_ABA is release 700, patch level 16. This patch level is required for
enhanced functionality, for example, additional icons in the GOS attachment
list, based on the SAP enhancement technology.
• Patch level for SAP CRM 7.0
The minimum requirement for software components SAP_BASIS and
SAP_ABA is release 701, patch level 03
BBPCRM release 700, patch level 02
WEBCUIF release 700, patch level 02.
Content Server integration widget is only supported for CRM 7.0 Ehp 1.
• Patch level for SAP SRM 7.0
The minimum requirement for software components SAP_BASIS and
SAP_ABA is release 701, patch level 07; for component SRM_SERVER the
minimum requirement is release 700, patch level 08.
• Patch level for optional Fiori UI package: At runtime the Fiori apps require
SAPUI5 1.38.9, which is based on User Interface Technology SAP_UI release
750. At installation time this package can be installed on SAP frontend
systems with User Interface Technology (SAP_UI release 740, patch level 13
or higher). The Fiori Add-On package of OpenText Archiving and Document
Access for SAP Solutions, OTEXBASF 1620_740 is required. Though not
required for installation, at runtime the Fiori app calls the OData services of
Extended ECM for SAP Solutions.
• Patch level for optional OData package: This package can be installed on SAP
backend systems either with Backend Event Provider (IW_BEP release 200,
patch level 10) or with SAP Gateway Foundation (SAP_GWFND, at least
release 740, patch level 09). On systems with SAP_GWFND release 750, like
S/4 HANA, use SPAM/SAINT level 0059 or newer for installation. Though
not required for installation, at runtime the OData services of Extended ECM
for SAP Solutions call RFC functions of the basis add-on of Extended ECM
for SAP Solutions (OTEXRL).

Note: The documentation and the release notes are updated regularly;
therefore, check for the latest version on OpenText My Support (https://
knowledge.opentext.com/knowledge/llisapi.dll/open/16514655).

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 15
ERLK160200-00-IGD-EN-05
Chapter 2 Prerequisites

Basis package of Archiving and Document Access for SAP Solutions

Prior to the SAP Add-on package OTEXRL of Extended ECM for SAP
Solutions you must install the SAP Add-On OTEXBAS of Archiving and
Document Access for SAP Solutions 16. For more information, see Section 3
“Installing Basis package” in OpenText Archiving and Document Access for SAP
Solutions - Installation and Upgrade Guide (ER-IGD).

2.3 Content Server system requirements


Check the following prerequisites prior to the installation of SAP Add-On package
OTEXRL:

Important
See the Release Notes for a comprehensive and most current list of
prerequisites.

Required patches for the installed Content Server version


Content Server 16.2 - The security fixes for Content Server are vital for proper
installation; if you already have a Content Server installation, make sure you
have installed Content Server 16.2. Additionally, install the additional patches
provided in the Patches folder on the installation medium and the current
Enterprise Library patch collection at https://knowledge.opentext.com/
knowledge/cs.dll/Open/21827049.
You can also use the cluster management tool to install patches. For more
information, see “Installing Content Server patches using the cluster
management tool“ on page 145.

Note: If you create a completely new system, Content Server 16.2 is


installed with the master setup.

Important
Prior to installation, make sure that you have read the information in
OpenText Enterprise Library - Installation and Upgrade Guide (EL-IGD) and
OpenText Enterprise Library - Scenario and Configuration Guide (EL-GGD)
for the relevant version.

Installation of Enterprise Library Services and Archive Center Services


Both services must be installed. Archive Center Services is part of Archive
Center. Install Enterprise Library Services 16.2 and Archive Center 16.2.
Additionally, install the patches provided on the Extended ECM for SAP
Solutions installation medium.

Important
Extended ECM for SAP Solutions is not compatible with the Enterprise
Library Interview module which is an optional Case Management
module. Do not install this module in combination with Extended ECM
for SAP Solutions.

16 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
2.4. SAP Add-On Installation Tool (SAINT)

ArchiveLink customizing
Customizing of the SAP system and the Archive and Storage Services must be
completed according to Part II “SAP basis customizing” in OpenText Archiving
and Document Access for SAP Solutions - Scenario Guide (ER-CCS).

Host/port for the logical archive


Check that store and retrieval of ArchiveLink documents functions properly
with the server.

Important
With the newest Archive Center version, the logical archive (OAC0
transaction) must use the Archive and Storage Services host/port.
For older versions, it must use the Enterprise Library Services host/port
and not the Archive and Storage Services host/port. In this case, restrict
access to the Archive and Storage Services host/port exclusively to the
Enterprise Library via a firewall configuration.

If you are using a firewall between SAP and Content Server the following ports
must be enabled:

• 8080 HTTP or 8090 HTTPS on Apache Webserver: used for the Web service
communication from SAP to Content Server.
• 8000: Used for the communication between Content Server and the SAP
Client.
• 80 (HTTP) or 443 (HTTP): Only required for connection tests from SAP to
Content Server.

2.4 SAP Add-On Installation Tool (SAINT)


Extended ECM for SAP Solutions uses the SAP Add-On Installation Tool (SAINT)
for installation of the SAP part of Extended ECM for SAP Solutions. SAINT uses
single PAT files (extension *.PAT) which integrate several transport files; these
collections are also called packages.

On the installation medium, the PAT file is archived in a SAPCAR file (extension
*.SAR) that can be extracted using the SAPCAR command line tool. The SAPCAR
file is located in a DATA folder below the package folder named as the package and
SAP release.

Note: The handling of the installation procedure within SAINT differs


depending on the SAP system used. For details see the SAP documentation.

Installation packages and passwords


The SAP package for Extended ECM for SAP Solutions is protected with a specific
password. During installation, this password is requested by SAINT.
For details, see the following table:

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 17
ERLK160200-00-IGD-EN-05
Chapter 2 Prerequisites

Table 2-1: Installation packages and passwords

Package Release Designation Password


OTEXRL 1620_700 Extended ECM for SAP 9386C726B8
Solutions
OTEXRLC 1620_700 Extended ECM for SAP 9586C745B8
Solutions SAP CRM Add-On
OTEXRLS 1620_700 Extended ECM for SAP 9386C755B8
Solutions SAP SRM Add-On
OTEXRLO 1620_700 Extended ECM for SAP 9386C749B8
Solutions SAP OData Services
Add-on
OTEXRLF 1620_740 Extended ECM for SAP 9086C740B8
Solutions SAP Fiori Apps Add-
On

Note: You only need these passwords and packages if they are not already
installed in your system.

2.5 Finding version information for Extended ECM


for SAP Solutions relevant system components
This chapter explains how you can find out which version of the different
components is used in your system.

Version information is also included in the system reports of Content Server and the
configuration report SAP System.

Tip: You find additional information about your systems in the following
reports:
• Section 20.1.1 “Understanding the SAP Diagnostic Program” in OpenText
Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD)
• Section 20.1.3 “Understanding the Configuration Report” in OpenText
Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD)
• Section 20.2 “Understanding the Content Server System Report” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD)
• Content Server
From the Content Server menu, select Help > About Content Server. The
version is displayed, for example Content Server 16. You find detailed information
also in the Content Server system report. For more information, see Section 20.2
“Understanding the Content Server System Report” in OpenText Extended ECM
for SAP Solutions - Customizing Guide (ERLK-CGD).
• Connected Workspaces module on Content Server

18 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
2.5. Finding version information for Extended ECM for SAP Solutions relevant system
components

On the Content Server Administration page, click Module Administration >


Install Modules. You see the version of the module next to its name, for example
16.0.0 .
• Web Services and other OpenText components
Go to Control Panel > Add/Remove Programs or Programs and Features. In the
list of programs, you see which version is installed.
• SAP System, Database information and OpenText Components
In the SAP IMG (transaction SPRO, OpenText Extended ECM for SAP Solutions
> Extended ECM > Configuration Report), run the Configuration Report to get
information about the SAP server. In this report, you find information like the
versions of OTEXBAS, OTEXERP, OTEXRL, OTEXRLC, OTEXRLS, OTEXBASO,
OTEXBASF, OTEXRLO, and OTEXRLF. For more information, see Section 20.1.3
“Understanding the Configuration Report” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).
• Support Package of installed SAP System
In the SAP GUI application, from the menu, select System > Status. Then click
Component information to see the installed SAP components with release
number and highest support package. If you only want to know the version
numbers of OTEXBAS, OTEXERP, OTEXRL, OTEXRLC, OTEXRLS, OTEXBASO,
OTEXBASF, OTEXRLO, and OTEXRLF you could use this instead of the
configuration report.
• SAP Fiori apps
For each application, there is a static version.html that includes the version
number. To retrieve the file, enter the following in a browser:

http(s)://<SAP hostname>:<SAP port>/sap/bc/ui5_ui5/otx/<subpath


of fiori app>/version.html

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 19
ERLK160200-00-IGD-EN-05
Chapter 3
Installing Extended ECM for SAP Solutions

This chapter describes the installation sequence for Extended ECM for SAP
Solutions.

Tip: The installation of a complete OpenText Extended ECM for SAP Solutions
environment is described in the following comprehensive installation
instructions:
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft
Windows with Microsoft SQL Server (ERLK-IWS)
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft
Windows with Oracle Database (ERLK-IWO)

Important
Always check for the most recent version of an installation guide on
OpenText My Support.

3.1 Installation sequence for Extended ECM for SAP


Solutions
1. In the SAP system, install the SAP packages:
• Archiving and Document Access (SAP Add-On) (OTEXBAS)
• Extended ECM for SAP Solutions (SAP Add-On) (OTEXRL)
2. On the server, install OpenText Extended ECM for SAP Solutions using the
master setup. During installation, select the following:
• Select the deployment scenario. For a typical all-in-one installation for one
instance of Content Server, select All-in-one Deployment (Archive Center,
Directory Services, Content Server, etc.).
For a two-server landscape, select Content Server Deployment on one server
and Extended Archive Center Deployment (Archive Center, Directory
Services, etc.) on the other server.
• In the Services section, keep the selections and select Extended ECM Web
Services in addition.
3. Install the required patches, see the respective installation guides. Also check the
installation medium for relevant patches.
4. Configure the following components :
• Configure Archive Center
• Configure Content Server

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 21
ERLK160200-00-IGD-EN-05
Chapter 3 Installing Extended ECM for SAP Solutions

• Configure OpenText Directory Services (OTDS)


•Configure modules
5. Configure Extended ECM for SAP Solutions:
• Set up security
• Set up communication with Enterprise Library Services and OTDS
• Configure Records Management (declaration, doctypes, jobs)
• Configure Extended ECM for SAP Solutions business functionality: business
workspaces, business attachments, business relations. For more information,
see OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-
CGD).
6. Install the clients:
• Install Imaging (Web Viewer, Windows Viewer, Enterprise Scan,
DesktopLink, ExchangeLink, NotesLink), Brava! View for SAP Solutions,
Brava! Server Components
• Install Enterprise Connect Client (MS Windows Explorer/MS Outlook)
• Install OpenText Administration Client

22 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 4
Installing the SAP package

The following describes the installation of the following components of Extended


ECM for SAP Solutions on an SAP application server.

• OTEXRLC (mandatory)
• OTEXTRLS
• OTEXRLO
• OTEXRLF

Prerequisites The component OTEXBAS of Archiving and Document Access for SAP Solutions must
be installed on your SAP system. If you want to integrate into SAP Fiori, also the
component OTEXBASF of Archiving and Document Access for SAP Solutions must be
installed on your SAP system. Check the Release Notes for required versions of
these components.

See also “SAP system requirements” on page 13 with general information on the
installation in an SAP environment.

To install the package:

1. Copy the respective SAPCAR files (*.SAR) located on the installation medium in
Extended ECM\SAP to the target SAP application server in the /usr/sap/trans
folder, which is the parent folder of the DIR_EPS_ROOT folder.

SAP Release File Source path Target path


SAP BASIS 700 OTEXRL_INST_1620_ INST_BAS_700\DAT /usr/sap/trans
700.SAR A\
SAP CRM 7.0 OTEXRLC_INST_162 INST_CRM_700\DA /usr/sap/trans
0_700.SAR TA\
SAP SRM 7.0 OTEXRLS_INST_1620 INST_SRM_700\DA /usr/sap/trans
_700.SAR TA\
IW_BEP release 200 OTEXRLO_INST_162 INST_ODATA_700\ /usr/sap/trans
or SAP_GWFND 0_700.SAR DATA
740/750
SAP_UI 740/750 OTEXRLF_INST_1620 INST_FIORI_740\D /usr/sap/trans
_740.SAR ATA

2. Extract the SAPCAR files to the /usr/sap/trans/EPS/in folder with the


following command:
SAPCAR -xvf <name of SAPCAR file>
The resulting PAT files will be extracted to the EPS/in folder relative to the path
of the SAPCAR files.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 23
ERLK160200-00-IGD-EN-05
Chapter 4 Installing the SAP package

Note: With Basis 7.00 or higher, you can use the SAINT and SPAM
transactions to upload and extract the SAR files from the frontend.

3. Carry out import of package as described in the respective SAP documentation.


For this, you will need the password for the package. For more information, see
“Installation packages and passwords” on page 17.

After the installation, you must activate a Business Configuration Set (BC set) for
every client.

To activate the BC set:

1. Start the SCPR20 transaction.


The Business Configuration Set screen appears.

2. Activate the following BC Set:

• /OTEXRL/RM_SEA

Note: For details, see the SAP documentation.

3. If you experience errors during BC set activation, repeat the respective


activation procedure up to 3 times.

24 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 5
Generating roles

The following relevant roles are delivered with the application:


• /OTX/RM_ADMIN
• /OTX/RM_CS_SAP_USER
• /OTX/RM_USER
• /OTX/RM_IMPERSONATED_USER_ROLE

To generate the roles:

1. Start the PFCG transaction.

2. On the Utilities menu, click Mass Generation.

3. Select Roles with Non-Current Profiles and in the Role field, enter /OTX/RM*.
After an upgrade, Roles with Current Profiles for New Generation and in the
Role field, enter /OTX/RM* to generate updated profiles.
4. Follow the steps to generate the profiles.

5. After an upgrade, perform a mass comparison:

a. On the Utilities menu, click Mass Comparison.


b. As role, enter /OTX/RM* and select Cleanups.
c. Follow the steps to do a mass comparison.

6. Start transaction PFCG and check the following roles one by one:

• /OTX/RM_ADMIN
• /OTX/RM_CS_SAP_USER
• /OTX/RM_USER
• /OTX/RM_IMPERSONATED_USER_ROLE

7. Ensure that the Authorizations tab has a green icon. If it is yellow, you must
regenerate the authorizations: Click Display Authorization Data, and then
Generate.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 25
ERLK160200-00-IGD-EN-05
Chapter 6
Installing language packages in the SAP system

This chapter describes how to install language packages in an SAP system.

Note: Depending on the delivery bundle, you may also have an ISO image file
containing installation files for components that must not be installed on an
SAP system.

The Add-On installation packages include the default language, which is English.
You must use the language packages to install other languages. For more
information about available languages, see Extended ECM for SAP Solutions Release
Notes. You can find the language packages related to the SAP Add-Ons of Extended
ECM for SAP Solutions on OpenText My Support (https://knowledge.opentext.com/
knowledge/cs.dll?func=ll&objId=8521552&objAction=browse).

To install a language package:

1. On OpenText My Support, go to OpenText Extended ECM for SAP Solutions


(https://knowledge.opentext.com/knowledge/cs.dll?func=ll&objId=8521552&
objAction=browse) and then go to the <Version> > Downloads area. Note that
you can also obtain the language packages for support packages and other
patches navigating through the Patches area. Do one of the following:

• If you have installed the installation Add-Ons, select and open the folder for
your version. Open the Language Packs folder, select and open your
language folder, and then download the
Extended_ECM_<version>_<language abbreviation>.zip file that
contains the language packages as *.SAR files.

For more details, see the text file stored with the corresponding language
package file in the language folder.

2. Upload your language file to your SAP system. Each ABAP Add-On has a
specific language package.

Example: OTEXRLDE30502_0000001 contains the German package for the OTEXRL


1002_700 Add-On on SAP_BASIS 7.00.

Note: Note the following options:


• If you use a system with SAP_BASIS 7.00, you can import and extract
the file directly in transaction SMLT.
• If you use any other system or prefer the manual handling, extract the
SAPCAR file with the .SAR extension to the SMLT path folder of your
SAP system. Usually the path is set to the EPS\in system folder. Use the
SAPCAR tool to extract the file.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 27
ERLK160200-00-IGD-EN-05
Chapter 6 Installing language packages in the SAP system

3. Use transaction SMLT to import your language package.

Important
Before starting to import language packages, OpenText recommends
reading the SAP help (http://help.sap.com/) about importing a language.
In the SAP help, navigate to the application help for the appropriate SAP
release and read the following chapters:
• Preparing to Import a Language
• Importing a Language
• Language Import with Transaction SMLT
• Post-Import Actions

4. After installing the language package, perform the necessary post-installation


steps, for example, such as those described in sections Language Supplementation/
Client Maintenance in the SAP help (http://help.sap.com/). Note that the
language package contains client dependent data which requires specific action
Client maintenance in transaction SMLT.

Note: After importing language packages to the SAP system, it can


become necessary to reset certain buffers. For example, you can use the
following transactions:
• /$SYNC - Reset all buffers
• /$OTR - Reset OTR text buffers (HTTP texts)
• /$CUA - Reset SAP GUI object buffers
• /$DYNP - Reset SAP GUI dynpro buffers

Note: Localization of Fiori apps

Starting with version 16.2 the Fiori apps contained in the Fiori UI Add-on
packages OTEXBASF and OTEXRLF deliver i18n properties files, which are
mapped to text tables on the SAP system. Therefore specific language packages
for Add-On packages OTEXBASF and OTEXRLF will be available in OpenText
My Support. The procedure of installation is the same as described above.

28 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 7
Installing the Content Server modules

The installation procedure closely resembles the procedure for any other Content
Server optional module.

7.1 Installation procedure on Content Server


The installation procedure consists of two stages which are both part of the
automated installation procedure:

1. Copying the module files to the <Content Server home>\staging directory


using the master setup.
2. Installing the modules into Content Server using the Install Modules page of
Content Server's administration interface.

7.2 Installing Content Server and modules files


Important
If you install on a Unix system, make sure that you are performing the setup
actions with the user who installed Content Server and runs the Content
Server service.

To install the module files:

1. Run the Mastersetup.exe file (Mastersetup for Unix) located on the


installation medium and accept the license agreement.

Tip: The installation procedure for Unix systems is similar to the Windows
based installation as described here.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 29
ERLK160200-00-IGD-EN-05
Chapter 7 Installing the Content Server modules

2. Select your deployment scenario. The module installation is included in the


Content Server Deployment scenario and in the All-in-one Deployment
scenario. Click Next.

30 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
7.2. Installing Content Server and modules files

3. Under Content Server and Modules, verify that the Connected Workspaces,
Extended ECM for SAP Solutions, and the Extended ECM Platform entries are
selected.
As the Enforce selection dependencies checkbox is selected as default, all the
dependent modules will be selected as well.

4. Click Next.
If more than one Content Server instance is installed, select the one to which
you want to add the Connected Workspaces module.

5. Check your entries in the Summary pane and click Install.

6. Content Server modules are installed using the same steps. The setups of
Content Server modules are initiated from the installer, one after the other. If
more than one Content Server instance is installed, select the one to which you
want to add the module. After the installation of the module is finished, the
installation of the next module starts automatically.
The files are copied to the staging directory of the server instance of Content
Server that you specified.

Tip: If you want to install the module to several Content Server instances,
you can start the Mastersetup.exe file again selecting another Content
Server instance.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 31
ERLK160200-00-IGD-EN-05
Chapter 7 Installing the Content Server modules

7.3 Installing the Content Server modules


You must install the required Content Server modules in a certain sequence to avoid
error messages during installation.
You must restart the server instance of Content Server between each step. For
information about starting and stopping Content Server servers, see the following
topic of the Content Server administration online help: Server Configuration >
Managing the Servers in Content Server > Stopping and Starting the Servers.

Caution
The installation fails if you check all listed modules simultaneously for
installation.

Notes
• Before you install the modules, check that the following modules are already
installed correctly:
• Case Management
• Content Server Document Templates
• The rest of the listed modules do not need to be installed for getting started if
there is no specific requirement that needs the modules.

To install Content Server modules:

1. Open the Content Server Administration page in a Web browser.

2. If prompted, enter the Content Server Administrator password in the


Administrator password field and click Log-in.

3. Select Module Administration > Install Modules.

4. From the Installable Modules list, install the modules in accordance to the
dependencies between the modules.
Start with installing required modules that do not have any dependencies listed
in the Dependencies column.

5. After the installation of the selected modules is completed, you must restart
Content Server.

6. Proceed with the next set of modules, which do not have any dependencies.
Restart Content Server.

7. Repeat this step until all modules are installed.

32 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 8
Installing language packs on Content Server

This chapter describes how to install language packs on Content Server. The module
installation packages and module support packages include the default language,
which is English. You must use the language packs to install other languages. For
more information about available languages, see the Release Notes.

Language packages for support packages

If not stated otherwise, the language packs related to support packages are
cumulative. They include merged language texts of the main version and of
previous and current support packages.

The language packs are available on OpenText My Support at the following location:
OpenText My Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/
63201449)

Note: Depending on the delivery bundle, you may also have an ISO image file
containing installation files for components that must not be installed on
Content Server, for example, language installations of Imaging clients and the
SAP language package. For more information, see the installation guides and
release notes for these components.

To install a language pack:

1. Download the language packs from OpenText My Support. You can also obtain
the language packs for support packages and other patches navigating through
the Patches area.
On the ISO image, the relevant files for the language packs are available in the
OpenText Content Server and Modules folder.

2. Unzip the files for the relevant modules in the root Content Server installation
directory.

3. On the Content Server Administration page, go to Languages > Install


Language Packs.

4. On the Install Language Packs page, in the Installable Content Server


Language Packs section, select Install for each language that you want to
install, and then click Install.
For more information about language packs, see Help for this page in the
Content Server help.

5. Restart your servers when prompted.

6. Click Continue.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 33
ERLK160200-00-IGD-EN-05
Chapter 9
Deploying Extended ECM Web Services

9.1 Deploying Extended ECM Web Services into the


application server
Install the Extended ECM Web Services on your Tomcat server.

Note: Make sure that your server has a sufficient initial memory pool. Refer to
Section 2.2.2 “Configuring Tomcat options” in OpenText Enterprise Library -
Installation and Upgrade Guide (EL-IGD) for memory pool size
recommendations.

The server must be running during the installation.

To deploy Extended ECM Web Services:

1. Run the Mastersetup.exe file (Mastersetup for Unix) located on the


installation medium and accept the license agreement.

2. Select Advanced Deployment (Custom Selection) and click Next.

3. Under Services, select the Extended ECM Web Services entry.


As the Enforce selection dependencies checkbox is selected as default, all the
dependent services will be selected as well.

4. Click Next and click Install.

5. Restart Tomcat manually once after the installation.

6. Only Unix systems: After deploying the services, change the directory of the
log files.

a. Open the <tomcat>/webapps/otsapxecm/WEB-INF/classes/log4j.xml


file.
b. Change the line <param name="File" value="logs/ecmlink.log" /> to
<param name="File" value="../logs/ecmlink.log" />

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 35
ERLK160200-00-IGD-EN-05
Chapter 9 Deploying Extended ECM Web Services

Figure 9-1: Deployment Scenario

36 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
9.2. Deploying Content Web Services

Figure 9-2: Services

9.2 Deploying Content Web Services


Extended ECM for SAP Solutions requires OpenText Content Web Services. During
the installation of Content Server, the Content Web Services WAR file is placed in
the <Content Server home>/webservices/java directory.

You must now deploy the web service cws to the Tomcat installation on the server
where you also installed Archive Center:

To deploy Content Web Services:

1. Copy the cws.war file from <Content Server home>/webservices/java to


your <Tomcat home>/webapps directory.

2. Only Unix systems: After deploying the services, change the directory of the
log files.

a. Open the [tomcat]/webapps/cws/WEB-INF/classes/log4j.xml file

b. Change the line <param name="File" value="logs/cws.log" />


to <param name="File" value="../logs/cws.log" />.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 37
ERLK160200-00-IGD-EN-05
Chapter 9 Deploying Extended ECM Web Services

9.3 Configuring host and port for Content Server in


Tomcat
After installation of the Apache Tomcat web server, and deployment of the
Extended ECM Web service, the server name is localhost with port 2099. You can
change these settings, for example if you need to address more than one Content
Server instance.

To change host name and port of Content Server:

1. Open the <Tomcat home>\webapps\otsapxecm\WEB-INF\web.xml file in an


editor.

2. Find the following elements and change the values according to your needs:

<context-param>
<param-name>LivelinkServer</param-name>
<param-value>cs.example.com</param-value>
</context-param>
<context-param>
<param-name>LivelinkServerPort</param-name>
<param-value>2099</param-value>
</context-param>
<context-param>
<param-name>LivelinkEncoding</param-name>
<param-value>UTF8</param-value>
</context-param>

3. Restart the Tomcat for the changes to take effect.

38 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Part 2
Upgrading Extended ECM for SAP
Solutions
Part 2 Upgrading Extended ECM for SAP Solutions

This part outlines the different upgrade scenarios.


• “Upgrade scenarios“ on page 41
• “General recommendations for the upgrade“ on page 45
• “Upgrading from Extended ECM for SAP Solutions 16 to 16.2“ on page 47
• “Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2“ on page 61
• “Upgrading from ECMLink 10.0.3, 10.0.4, or 10.5.0“ on page 77
• “Upgrading from ECMLink 9.8.x, 10.0, or 10.0 SP1 or SP2“ on page 79
• “Upgrading from versions prior to 9.8“ on page 81

40 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 10
Upgrade scenarios

There are different upgrade scenarios depending on the Content Server version from
which you upgrade.

Table 10-1: Upgrade from ECMLink 10.5.1 or Extended ECM for SAP Solutions
16 to Extended ECM for SAP Solutions 16.2

Old Content Old module New Content New Connected New Extended
Server version version Server version Workspaces ECM for SAP
module version Solutions SAP
Add-on version
Content Server ECMLink 10.5.1 Content Connected Extended ECM
10.5 SP1 Server 16.2 Workspaces 16.2 for SAP
Solutions 16.2
Extended ECM
Platform 16.2

Extended ECM
for SAP 16.2
Content Server Connected Content Connected Extended ECM
16 Workspaces 16 Server 16.2 Workspaces 16.2 for SAP
Solutions 16.2
Extended ECM
Platform 16.2

Extended ECM
for SAP 16.2

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 41
ERLK160200-00-IGD-EN-05
Chapter 10 Upgrade scenarios

Figure 10-1: Upgrade from ECMLink 10.5.1 or Extended ECM for SAP Solutions
16 or to Extended ECM for SAP Solutions 16.2

10.1 Supported combinations


You can split up the upgrade to two maintenance windows. You can either update
the Content Server system first or the SAP system first. The new Content Server
system will also be working with an SAP system that is not updated yet and vice
versa. . “Supported combinations” on page 42 lists possible working combinations
of old and new versions of the Content Server module and the SAP Add-on. For
information about the necessary steps see the checklists for the different upgrade
paths.

For the different combinations, there may be limitations. For information about all
known issues, see the Release Notes.

Table 10-2: Supported combinations

Content Server Content Server SAP Add-on version Limitations for


version module version different SAP
Systems
10.5 10.5.1 10.5.1

42 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
10.1. Supported combinations

Content Server Content Server SAP Add-on version Limitations for


version module version different SAP
Systems
10.5 10.5.1 16.2
16 16 16
16.2 16.2 16
16 16 16.2
16.2 16.2 16.2

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 43
ERLK160200-00-IGD-EN-05
Chapter 11
General recommendations for the upgrade

When you perform an upgrade, you have to upgrade the various components of
Extended ECM for SAP Solutions.

Note: Always use the latest patches for upgrade. Especially always install the
latest patch for Connected Workspaces before you upgrade the database
schema.

To perform an upgrade:

1. Refer to the Release Notes of Extended ECM for SAP Solutions to determine
which versions of the different components are required. The ISO image
contains all supported components. The master setup does not show all of them.

2. Plan your upgrade procedure. OpenText recommends the following:

a. Retrieve all related documentation. Since many different components are


involved you will need to go through many different guides.
Refer to Section 5 “Upgrading Enterprise Library” in OpenText Enterprise
Library - Installation and Upgrade Guide (EL-IGD). This guide describes the
different stages of the upgrade and refers to other relevant guides.
b. Perform the upgrade on your development systems. One option is to split
up the upgrade procedure: In a first maintenance window, upgrade
Content Server and all related components. Test if the new version is
running with the old components in the SAP system. Later, in a second
maintenance window upgrade the relevant components in the SAP system.
The other way is supported, too. For more information, see “Supported
combinations” on page 42.
Note the exact procedure with all necessary steps.
c. Perform the upgrade on the test system. Follow exactly the steps you noted
to verify the procedure. If necessary, adapt the list.
d. Perform the upgrade on the productive system. OpenText recommends to
have two maintenance windows: The first for the upgrade of Content
Server and all related components, the second for the components in the
SAP system. The other way is supported, too. For more information, see
“Supported combinations” on page 42.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 45
ERLK160200-00-IGD-EN-05
Chapter 12

Upgrading from Extended ECM for SAP Solutions


16 to 16.2

“Supported combinations” on page 42 lists possible working combinations of old


and new versions of the Content Server module and the SAP Add-on. For
information about the necessary steps see the checklists for the different upgrade
paths.

12.1 Checklist for upgrade from Extended ECM for


SAP Solutions 16 to 16.2
Table 12-1: Upgrade checklist for upgrade from Extended ECM for SAP
Solutions 16 to 16.2 (Content Server and modules first)

Step System and Tools Information


Upgrading to Content Server 16.2 and Content Server module
Prepare your system for the All OpenText systems For more information, see
upgrade Section 5 “Upgrading
Enterprise Library” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD) and the linked
guides.
Migrate OpenText Directory Server on which Directory For more information, see
Services to version 16.2 Services is installed, using Section 1.2 “Importing data
Administration Client, and from previous versions of
Content Server Directory Services” in
OpenText Directory Services -
Installation and Administration
Guide (OTDS-IWC).
Upgrade and configure Archive Center For more information, see
Archive Center Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.
• Use Directory Services
authentication.
• Use the new resource ID
that was created for
Archive Center during
Directory Services
migration.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 47
ERLK160200-00-IGD-EN-05
Chapter 12 Upgrading from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


(only relevant if you are For more information, see
using Document Pipelines): OpenText Document Pipeline -
Upgrade Document Installation and Upgrade Guide
Pipelines. (AR-IDPDP)
Upgrade Content Server and Content Server Make a copy of the Content
Enterprise Library Services Server installation directory
first. For more information,
see Section 1.3 “Preparing
Content Server in your
Source Environment” in
OpenText Content Server -
Upgrade Guide (LLESCOR-
IUP). Uninstall the old
Content Server version and
delete the installation
directory. Install the new
version in a directory with
the same name.

To upload the certificate,


open the Administration
Client and connect with the
server and navigate to
Enterprise Library Services >
Configuration.

For information about


Enterprise Library Services,
see Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD),
and the linked guides.

To view the certificates, open


the Administration Client,
connect with Archive Center,
and navigate to System >
Key Store > Certificates. The
CS_ELIB_<hostname>
certificates displays on the
Global tab.
Install the Updates for For more information, see
Content Server and Archive Section 5.1 “Upgrade
Center, and finish the roadmap” in OpenText
Archive Center Enterprise Library - Installation
configuration. Always use and Upgrade Guide (EL-IGD)
the latest patches from and the linked guides.
OpenText My Support.

48 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
12.1. Checklist for upgrade from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


Install the new Connected Content Server For more information, see
Workspaces module and all “Installation procedure on
other modules that were Content Server” on page 29.
installed before. Always use
the latest patches from
OpenText My Support.
If you are working with With the upgrade, the
appearances, update the appearances are
relevant path automatically renamed from
SAPBASE_* to
EXTENDED_ECM_*. In the
content of all relevant
appearances, in the header,
replace sapbase with
otsapxecm.

If you are performing an in-


parallel upgrade of Content
Server, run the following tool
to ensure that the
configuration is updated
correctly:

http://server/otcs/
cs.exe?
func=otsapxecm.Config
ure&module=otsapxecm
Deploy the Extended ECM For more information, see
Web Services “Deploying Extended ECM
Web Services into the
application server”
on page 35.
Connect the new Content Content Server Connect the old database and
Server with the old database upgrade it. For more
and upgrade the database. information, see Section 1.5.1
“Upgrading your Content
Server Database” in OpenText
Content Server - Upgrade Guide
(LLESCOR-IUP).
Upgrade the database Content Server “Upgrading the database
schema. Make sure you schema” on page 59
installed the latest patches
from OpenText My Support.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 49
ERLK160200-00-IGD-EN-05
Chapter 12 Upgrading from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


For the Template Workspaces Content Server This step is required if your
module, perform the previous version
configuration upgrade and was Template Workspaces
the data upgrade 10.1, Contract Management
10.1, Case Management
Framework 1.1.0, 10.0.0 or
Contract Management 2.1.1.
Additionally, in the Template
Workspace Administration
section, you need to do the
upgrade step.
Make sure the
LivelinkDocumentTempl
ates setting is moved from
the opentext.ini of the
old Content Server system to
the new one. After that,
perform the configuration
and data upgrade. For more
information, see Section 3
“Upgrading Template
Workspaces from the Admin
page” in OpenText Template
Workspaces - Installation and
Administration Guide
(LLESCSB-IGD)
Perform post-upgrade steps SAP system • Change the logical port
in the SAP system for Content Server
Member Services from
les-services to cws.
• Update the connection
settings to point to the
new systems. For more
information, see
“Maintaining Extended
ECM connections”
on page 114.

50 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
12.1. Checklist for upgrade from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


Perform post-upgrade steps Directory Services • Update the Content
in Directory Services Server resource settings to
point to the new systems.
• Update the Content
Server resource settings to
point to Content Web
Services cws instead of
les-services.
For more information, see
Section 6.3 “Creating and
configuring resources for
Directory Services” in
OpenText Extended ECM
for SAP Solutions - User
Management and Access
Control Scenarios (ERLK-
CUM)
If you encounter problems,
re-create the Content Server
resource.
Perform post-upgrade steps Content Server If there is a change in the
in Content Server Archive Center port or
system, update the setting in
Content Server in the
Archive Storage Provider
settings.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 51
ERLK160200-00-IGD-EN-05
Chapter 12 Upgrading from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


Perform post-upgrade steps Archive Center Upload the relevant
in Archive Center certificates and enable them
for Archive Center and for
the logical archives. The
following certificates are
relevant:
• CS_ELIB_<hostname>:
Enterprise Enterprise
Library Services
certificate
• SP_<hostname>: Archive
Storage Services
certificate
For more information, see
Section 4.7 “Configuring
security settings and
connection details” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD) and Section 5.2
“Starting services and
concluding upgrade” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD)
Upgrade clients Clients Upgrade the Enterprise
Connect client after the
Enterprise Connect module
and the Office Editor module
are updated.
After this maintenance window and all relevant steps, the new systems are working with
the old SAP system. All scenarios work without changing the configuration further.
Upgrading the SAP Add-on
Upgrade Extended ECM for SAP system “Upgrading to Extended
SAP Solutions Add-on from ECM for SAP Solutions in the
16 to 16.2 SAP system” on page 60
Upgrade the Fiori Add-On SAP system Do the upgrade in the same
from 16 to 16.2 maintenance window or
before if you already have an
SAP Fiori Gateway with
Business Workspace app 16
running against an SAP
Backend which is updated
from 16 to 16.2.

52 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
12.1. Checklist for upgrade from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


If the connection test on SAP system Do one of the following:
Content Server does not • Create a new web service
work, configure the Service binding in the
Provider Interface again. SOAMANAGER and
switch all the connections
on Content Server side to
use the new binding.
• Delete the old web service
binding and create a new
web service binding in the
SOAMANAGER with the
same settings as before.
Changes on Content
Server are not necessary.
For more information, see
“Configuring the Service
Provider Interface service”
on page 113.

Also recreate the logical ports


and activate them. For more
information, see “Creating
logical ports in the SAP
system” on page 95
Perform post-installation Content Server and SAP Perform post-installation
steps system steps. For more information,
see “Post-installation and
post-upgrade tasks”
on page 83.
Verify the installation SAP system Run the Diagnostics
Program. For more
information, see
“Understanding the SAP
Diagnostic Program”
on page 135.

Table 12-2: Upgrade checklist for upgrade from Extended ECM for SAP
Solutions 16 to 16.2 (SAP system first)

Step System and Tools Information


Upgrading the SAP Add-on
Upgrade Extended ECM for SAP system “Upgrading to Extended
SAP Solutions Add-on from ECM for SAP Solutions in the
16 to 16.2 SAP system” on page 60

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 53
ERLK160200-00-IGD-EN-05
Chapter 12 Upgrading from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


Upgrade the Fiori Add-On SAP system Do the upgrade in the same
from 16 to 16.2 maintenance window or
before if you already have an
SAP Fiori Gateway with
Business Workspace app 16
running against an SAP
Backend which is updated
from 16 to 16.2.
Install the newest cumulative Content Server Refer to the Release Notes for
patch for Extended ECM for 16 for information about the
SAP Solutions and other current cumulative patch.
relevant patches. Download the patch from
OpenText My Support
(https://
knowledge.opentext.com/
knowledge/llisapi.dll/open/
16514655).
After this maintenance window and all relevant steps, the SAP system works with the old
Content Server module.
Upgrading to Content Server 16.2 and newest Content Server module
Prepare your system for the All OpenText systems For more information, see
upgrade Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.
Migrate OpenText Directory Server on which Directory For more information, see
Services to version 16 Services is installed and Section 1.2 “Importing data
Content Server from previous versions of
Directory Services” in
OpenText Directory Services -
Installation and Administration
Guide (OTDS-IWC).
Upgrade and configure Archive Center For more information, see
Archive Center Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.
• Use Directory Services
authentication.
• Use the new resource ID
that was created for
Archive Center during
Directory Services
migration.

54 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
12.1. Checklist for upgrade from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


(only relevant if you are For more information, see
using Document Pipelines): OpenText Document Pipeline -
Upgrade Document Installation and Upgrade Guide
Pipelines. (AR-IDPDP).
Upgrade Content Server and Content Server Make a copy of the Content
Enterprise Library Services Server installation directory
first. For more information,
see Section 1.3 “Preparing
Content Server in your
Source Environment” in
OpenText Content Server -
Upgrade Guide (LLESCOR-
IUP). Uninstall the old
Content Server version and
delete the installation
directory. Install the new
version in a directory with
the same name.

To upload the certificate,


open the Administration
Client and connect with the
server and navigate to
Enterprise Library Services >
Configuration.

For information about


Enterprise Library Services,
see Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD),
and the linked guides.

To view the certificates, open


the Administration Client,
connect with Archive Center,
and navigate to System >
Key Store > Certificates. The
CS_ELIB_<hostname>
certificates displays on the
Global tab.
Install the Updates for For more information, see
Content Server and Archive Section 5.1 “Upgrade
Center, and finish the roadmap” in OpenText
Archive Center configuration Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 55
ERLK160200-00-IGD-EN-05
Chapter 12 Upgrading from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


If you are working with With the upgrade, the
appearances, update the appearances are
relevant path automatically renamed from
SAPBASE_* to
EXTENDED_ECM_*. In the
content of all relevant
appearances, in the header,
replace sapbase with
otsapxecm.

If you are performing an in-


parallel upgrade of Content
Server, run the following tool
to ensure that the
configuration is updated
correctly:

http://server/otcs/
cs.exe?
func=otsapxecm.Config
ure&module=otsapxecm
Deploy the Extended ECM For more information, see
Web Services “Deploying Extended ECM
Web Services into the
application server”
on page 35
Connect the new Content Content Server Connect the old database and
Server with the old database upgrade it. For more
and upgrade the database. information, see Section 1.5.1
“Upgrading your Content
Server Database” in OpenText
Content Server - Upgrade Guide
(LLESCOR-IUP).
Upgrade the database Content Server “Upgrading the database
schema schema” on page 59

56 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
12.1. Checklist for upgrade from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


For the Template Workspaces Content Server This step is required if your
module, perform the previous version
configuration upgrade and was Template Workspaces
the data upgrade 10.1, Contract Management
10.1, Case Management
Framework 1.1.0, 10.0.0 or
Contract Management 2.1.1.
Additionally, in the Template
Workspace Administration
section you need to do the
upgrade step.
Make sure the
LivelinkDocumentTempl
ates setting is moved from
the opentext.ini of the
old Content Server system to
the new one. After that,
perform the configuration
and data upgrade. For more
information, see Section 3
“Upgrading Template
Workspaces from the Admin
page” in OpenText Template
Workspaces - Installation and
Administration Guide
(LLESCSB-IGD)
Perform post-upgrade steps Directory Services • Update the Content
in Directory Services Server resource settings to
point to the new systems.
• Update the Content
Server resource settings to
point to Content Web
Services cws instead of
les-services.
For more information, see
Section 6.3 “Creating and
configuring resources for
Directory Services” in
OpenText Extended ECM
for SAP Solutions - User
Management and Access
Control Scenarios (ERLK-
CUM)
If you encounter problems,
re-create the Content Server
resource.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 57
ERLK160200-00-IGD-EN-05
Chapter 12 Upgrading from Extended ECM for SAP Solutions 16 to 16.2

Step System and Tools Information


Perform post-upgrade steps Content Server If there is a change in the
in Content Server Archive Centerport or
system, update the setting in
Content Server in the
Archive Storage Provider
settings.
Perform post-upgrade steps Archive Center Upload the relevant
in Archive Center certificates and enable them
for Archive Center and for
the logical archives. The
following certificates are
relevant:
• CS_ELIB_<hostname>:
Enterprise Library
Services certificate
• SP_<hostname>: Archive
Storage Services
certificate
For more information, see
Section 4.7 “Configuring
security settings and
connection details” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD) and Section 5.2
“Starting services and
concluding upgrade” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD)
Upgrade clients Clients Upgrade the Enterprise
Connect client after the
Enterprise Connect module
and the Office Editor module
are updated.
Perform post-upgrade steps SAP system • Change the logical port
in the SAP system for Content Server
Member Services from
les-services to cws.
• Update the Enterprise
Library settings to point
to the new systems. For
more information, see
“Maintaining Extended
ECM connections”
on page 114.

58 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
12.2. Upgrading the database schema

Step System and Tools Information


If the connection test on SAP system Do one of the following:
Content Server does not • Create a new web service
work, configure the Service binding in the
Provider Interface again. SOAMANAGER and
switch all the connections
on Content Server side to
use the new binding.
• Delete the old web service
binding and create a new
web service binding in the
SOAMANAGER with the
same settings as before.
Changes on Content
Server are not necessary.
For more information, see
“Configuring the Service
Provider Interface service”
on page 113.

Also recreate the logical ports


and activate them. For more
information, see “Creating
logical ports in the SAP
system” on page 95
Perform post-installation SAP system Perform the remaining post-
steps installation steps. For more
information, see “Post-
installation and post-upgrade
tasks” on page 83.
Verify the installation SAP system Run the Diagnostics
Program. For more
information, see
“Understanding the SAP
Diagnostic Program”
on page 135.

12.2 Upgrading the database schema


The current version of the Connected Workspaces module changes database tables.

The database schema is upgraded with the standard Content Server mechanism.
When an upgrade is necessary, you are prompted accordingly and can upgrade the
database.

Note: You can monitor the database schema upgrade in a separate log file. This
log file is created in the logs directory of Content Server during the upgrade:
ECMLinkDBSchemaUpgrade_<threadID>.log. It logs all SQL statements of the
upgrade.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 59
ERLK160200-00-IGD-EN-05
Chapter 12 Upgrading from Extended ECM for SAP Solutions 16 to 16.2

Important
Make sure that you installed the latest patch of Connected Workspaces
before you upgrade the database schema.

12.3 Upgrading to Extended ECM for SAP Solutions in


the SAP system
Note: After the previous steps, you can still work with the old version in the
SAP system. So you can move the upgrade of Extended ECM for SAP Solutions
in the SAP system to a later maintenance window.
• If you want to migrate to S/4HANA which is supported by OpenText Extended
ECM for SAP Solutions 16, see the respective SAP documentation for information
about all relevant prerequisites and steps.
• Install all required SAP Notes. For more information, see “SAP system
requirements” on page 13.
• Install the relevant packages for Archiving and Document Access for SAP
Solutions 16.2 with the SAINT tool.
• Install the relevant packages for OpenText Extended ECM for SAP Solutions 16.2
with the SAINT tool. For more information, see “Installation procedure on
Content Server” on page 29.
• In the IMG, go to the Maintain Extended ECM Connections activity and change
the External System ID from the old connection to the new connection. For more
information, see “Maintaining Extended ECM connections” on page 114.
Ensure that for the HTTP connection to OTDS, the option Send SAP Logon
Ticket is selected. For more information, see “Creating logical ports for SAP
Basis 7.0” on page 95.
• Activate the BC sets. For more information, see “Installing the SAP package“
on page 23.

60 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 13
Upgrading from ECMLink 10.5.1 with Content
Server 10.5 to Extended ECM for SAP Solutions
16.2

“Supported combinations” on page 42 lists possible working combinations of old


and new versions of the Content Server module and the SAP Add-on. For
information about the necessary steps see the checklists for the different upgrade
paths.

13.1 Checklist for upgrade from ECMLink 10.5.1 with


Content Server 10.5 SP1 to Extended ECM for
SAP Solutions 16.2
Table 13-1: Upgrade checklist for upgrade from ECMLink 10.5.1 with Content
Server 10.5 SP1 to Extended ECM for SAP Solutions 16.2 (Content Server and
modules first)

Step System and Tools Information


Upgrading to Content Server 16.2 and Content Server module
Prepare your system for the All OpenText systems For more information, see
upgrade Section 5 “Upgrading
Enterprise Library” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD) and the linked
guides.
Migrate OpenText Directory Server on which Directory For more information, see
Services to version 16.2 Services is installed, using Section 1.2 “Importing data
Administration Client, and from previous versions of
Content Server Directory Services” in
OpenText Directory Services -
Installation and Administration
Guide (OTDS-IWC).

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 61
ERLK160200-00-IGD-EN-05
Chapter 13 Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2

Step System and Tools Information


Upgrade and configure Archive Center For more information, see
Archive Center Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.
• Use Directory Services
authentication.
• Use the new resource ID
that was created for
Archive Center during
Directory Services
migration.
(only relevant if you are For more information, see
using Document Pipelines): OpenText Document Pipeline -
Upgrade Document Installation and Upgrade Guide
Pipelines. (AR-IDPDP)

62 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
13.1. Checklist for upgrade from ECMLink 10.5.1 with Content Server 10.5 SP1 to Extended
ECM for SAP Solutions 16.2

Step System and Tools Information


Upgrade Content Server and Content Server Make a copy of the Content
Enterprise Library Services Server installation directory
first. For more information,
see Section 1.3 “Preparing
Content Server in your
Source Environment” in
OpenText Content Server -
Upgrade Guide (LLESCOR-
IUP). Uninstall the old
Content Server version and
delete the installation
directory. Install the new
version in a directory with
the same name.

To upload the certificate,


open the Administration
Client and connect with the
server and navigate to
Enterprise Library Services >
Configuration.

For information about


Enterprise Library Services,
see Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD),
and the linked guides.

To view the certificates, open


the Administration Client,
connect with Archive Center,
and navigate to System >
Key Store > Certificates. The
CS_ELIB_<hostname>
certificates displays on the
Global tab.
Install the Updates for For more information, see
Content Server and Archive Section 5.1 “Upgrade
Center, and finish the roadmap” in OpenText
Archive Center configuration Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.
Install the new Connected Content Server For more information, see
Workspaces module and all “Installation procedure on
other modules that were Content Server” on page 29.
installed before.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 63
ERLK160200-00-IGD-EN-05
Chapter 13 Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2

Step System and Tools Information


If you are working with With the upgrade, the
appearances, update the appearances are
relevant path automatically renamed from
SAPBASE_* to
EXTENDED_ECM_*. In the
content of all relevant
appearances, in the header,
replace sapbase with
otsapxecm.

If you are performing an in-


parallel upgrade of Content
Server, run the following tool
to ensure that the
configuration is updated
correctly:

http://server/otcs/
cs.exe?
func=otsapxecm.Config
ure&module=otsapxecm
Deploy the Extended ECM For more information, see
Web Services “Deploying Extended ECM
Web Services into the
application server”
on page 35.
Connect the new Content Content Server Connect the old database and
Server with the old database upgrade it. For more
and upgrade the database. information, see Section 1.5.1
“Upgrading your Content
Server Database” in OpenText
Content Server - Upgrade Guide
(LLESCOR-IUP).
Upgrade the database Content Server “Upgrading the database
schema schema” on page 74

64 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
13.1. Checklist for upgrade from ECMLink 10.5.1 with Content Server 10.5 SP1 to Extended
ECM for SAP Solutions 16.2

Step System and Tools Information


For the Template Workspaces Content Server This step is required if your
module, perform the previous version
configuration upgrade and was Template Workspaces
the data upgrade 10.1, Contract Management
10.1, Case Management
Framework 1.1.0, 10.0.0 or
Contract Management 2.1.1.
Additionally, in the Template
Workspace Administration
section, you need to do the
upgrade step.
Make sure the
LivelinkDocumentTempl
ates setting is moved from
the opentext.ini of the
old Content Server system to
the new one. After that,
perform the configuration
and data upgrade. For more
information, see Section 3
“Upgrading Template
Workspaces from the Admin
page” in OpenText Template
Workspaces - Installation and
Administration Guide
(LLESCSB-IGD)
Perform post-upgrade steps SAP system • Change the logical port
in the SAP system for Content Server
Member Services from
les-services to cws.
• Update the connection
settings to point to the
new systems. For more
information, see
“Maintaining Extended
ECM connections”
on page 114.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 65
ERLK160200-00-IGD-EN-05
Chapter 13 Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2

Step System and Tools Information


Perform post-upgrade steps Directory Services • Update the Content
in Directory Services Server resource settings to
point to the new systems.
• Update the Content
Server resource settings to
point to Content Web
Services cws instead of
les-services.
For more information, see
Section 6.3 “Creating and
configuring resources for
Directory Services” in
OpenText Extended ECM
for SAP Solutions - User
Management and Access
Control Scenarios (ERLK-
CUM)
If you encounter problems,
re-create the Content Server
resource.
Perform post-upgrade steps Content Server If there is a change in the
in Content Server Archive Center port or
system, update the setting in
Content Server in the
Archive Storage Provider
settings.

66 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
13.1. Checklist for upgrade from ECMLink 10.5.1 with Content Server 10.5 SP1 to Extended
ECM for SAP Solutions 16.2

Step System and Tools Information


Perform post-upgrade steps Archive Center Upload the relevant
in Archive Center certificates and enable them
for Archive Center and for
the logical archives. The
following certificates are
relevant:
• CS_ELIB_<hostname>:
Enterprise Enterprise
Library Services
certificate
• SP_<hostname>: Archive
Storage Services
certificate
For more information, see
Section 4.7 “Configuring
security settings and
connection details” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD) and Section 5.2
“Starting services and
concluding upgrade” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD)
Upgrade clients Clients Upgrade the Enterprise
Connect client after the
Enterprise Connect module
and the Office Editor module
are updated.
After this maintenance window and all relevant steps, the new systems are working with
the old SAP system. All scenarios work without changing the configuration further. There
are some restrictions though:
• For all SAP systems: No integration widget support.
• SAP Fiori Extended ECM: No support
Upgrading the SAP Add-on
Upgrade Extended ECM for SAP system “Upgrading to Extended
SAP Solutions Add-on from ECM for SAP Solutions in the
10.5.1 to 16.2 SAP system” on page 75

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 67
ERLK160200-00-IGD-EN-05
Chapter 13 Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2

Step System and Tools Information


If the connection test on SAP system Do one of the following:
Content Server does not • Create a new web service
work, configure the Service binding in the
Provider Interface again. SOAMANAGER and
switch all the connections
on Content Server side to
use the new binding.
• Delete the old web service
binding and create a new
web service binding in the
SOAMANAGER with the
same settings as before.
Changes on Content
Server are not necessary.
For more information, see
“Configuring the Service
Provider Interface service”
on page 113.

Also recreate the logical ports


and activate them. For more
information, see “Creating
logical ports in the SAP
system” on page 95
Perform post-installation Content Server and SAP Perform post-installation
steps system steps. For more information,
see “Post-installation and
post-upgrade tasks”
on page 83.
Verify the installation SAP system Run the Diagnostics
Program. For more
information, see
“Understanding the SAP
Diagnostic Program”
on page 135.

Table 13-2: Upgrade checklist for upgrade from ECMLink 10.5.1 with Content
Server 10.5 SP1 to Extended ECM for SAP Solutions 16.2 (SAP system first)

Step System and Tools Information


Upgrading the SAP Add-on
Upgrade Extended ECM for SAP system “Upgrading to Extended
SAP Solutions Add-on from ECM for SAP Solutions in the
10.5.1 to 16.2 SAP system” on page 75

68 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
13.1. Checklist for upgrade from ECMLink 10.5.1 with Content Server 10.5 SP1 to Extended
ECM for SAP Solutions 16.2

Step System and Tools Information


Install the newest cumulative Content Server Refer to the Release Notes for
patch for ECMLink 10.5.1 10.5 SP1 for information
and other relevant patches. about the current cumulative
patch. Download the patch
from OpenText My Support
(https://
knowledge.opentext.com/
knowledge/llisapi.dll/open/
16514655).
After this maintenance window and all relevant steps, the SAP system works with the old
Content Server module. There are some restrictions though:
• For all SAP systems: No integration widget support.
Upgrading to Content Server 16.2 and newest Content Server module
Prepare your system for the All OpenText systems For more information, see
upgrade Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.
Migrate OpenText Directory Server on which Directory For more information, see
Services to version 16.2 Services is installed and Section 1.2 “Importing data
Content Server from previous versions of
Directory Services” in
OpenText Directory Services -
Installation and Administration
Guide (OTDS-IWC).
Upgrade and configure Archive Center For more information, see
Archive Center Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.
• Use Directory Services
authentication.
• Use the new resource ID
that was created for
Archive Center during
Directory Services
migration.
(only relevant if you are For more information, see
using Document Pipelines): OpenText Document Pipeline -
Upgrade Document Installation and Upgrade Guide
Pipelines. (AR-IDPDP).

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 69
ERLK160200-00-IGD-EN-05
Chapter 13 Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2

Step System and Tools Information


Upgrade Content Server and Content Server Make a copy of the Content
Enterprise Library Services Server installation directory
first. For more information,
see Section 1.3 “Preparing
Content Server in your
Source Environment” in
OpenText Content Server -
Upgrade Guide (LLESCOR-
IUP). Uninstall the old
Content Server version and
delete the installation
directory. Install the new
version in a directory with
the same name.

To upload the certificate,


open the Administration
Client and connect with the
server and navigate to
Enterprise Library Services >
Configuration.

For information about


Enterprise Library Services,
see Section 5.1 “Upgrade
roadmap” in OpenText
Enterprise Library - Installation
and Upgrade Guide (EL-IGD),
and the linked guides.

To view the certificates, open


the Administration Client,
connect with Archive Center,
and navigate to System >
Key Store > Certificates. The
CS_ELIB_<hostname>
certificates displays on the
Global tab.
Install the Updates for For more information, see
Content Server and Archive Section 5.1 “Upgrade
Center, and finish the roadmap” in OpenText
Archive Center configuration Enterprise Library - Installation
and Upgrade Guide (EL-IGD)
and the linked guides.

70 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
13.1. Checklist for upgrade from ECMLink 10.5.1 with Content Server 10.5 SP1 to Extended
ECM for SAP Solutions 16.2

Step System and Tools Information


If you are working with With the upgrade, the
appearances, update the appearances are
relevant path automatically renamed from
SAPBASE_* to
EXTENDED_ECM_*. In the
content of all relevant
appearances, in the header,
replace sapbase with
otsapxecm.

If you are performing an in-


parallel upgrade of Content
Server, run the following tool
to ensure that the
configuration is updated
correctly:

http://server/otcs/
cs.exe?
func=otsapxecm.Config
ure&module=otsapxecm
Deploy the Extended ECM For more information, see
Web Services “Deploying Extended ECM
Web Services into the
application server”
on page 35
Connect the new Content Content Server Connect the old database and
Server with the old database upgrade it. For more
and upgrade the database. information, see Section 1.5.1
“Upgrading your Content
Server Database” in OpenText
Content Server - Upgrade Guide
(LLESCOR-IUP).
Upgrade the database Content Server “Upgrading the database
schema schema” on page 74

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 71
ERLK160200-00-IGD-EN-05
Chapter 13 Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2

Step System and Tools Information


For the Template Workspaces Content Server This step is required if your
module, perform the previous version
configuration upgrade and was Template Workspaces
the data upgrade 10.1, Contract Management
10.1, Case Management
Framework 1.1.0, 10.0.0 or
Contract Management 2.1.1.
Additionally, in the Template
Workspace Administration
section you need to do the
upgrade step.
Make sure the
LivelinkDocumentTempl
ates setting is moved from
the opentext.ini of the
old Content Server system to
the new one. After that,
perform the configuration
and data upgrade. For more
information, see Section 3
“Upgrading Template
Workspaces from the Admin
page” in OpenText Template
Workspaces - Installation and
Administration Guide
(LLESCSB-IGD)
Perform post-upgrade steps Directory Services • Update the Content
in Directory Services Server resource settings to
point to the new systems.
• Update the Content
Server resource settings to
point to Content Web
Services cws instead of
les-services.
For more information, see
Section 6.3 “Creating and
configuring resources for
Directory Services” in
OpenText Extended ECM
for SAP Solutions - User
Management and Access
Control Scenarios (ERLK-
CUM)
If you encounter problems,
re-create the Content Server
resource.

72 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
13.1. Checklist for upgrade from ECMLink 10.5.1 with Content Server 10.5 SP1 to Extended
ECM for SAP Solutions 16.2

Step System and Tools Information


Perform post-upgrade steps Content Server If there is a change in the
in Content Server Archive Centerport or
system, update the setting in
Content Server in the
Archive Storage Provider
settings.
Perform post-upgrade steps Archive Center Upload the relevant
in Archive Center certificates and enable them
for Archive Center and for
the logical archives. The
following certificates are
relevant:
• CS_ELIB_<hostname>:
Enterprise Library
Services certificate
• SP_<hostname>: Archive
Storage Services
certificate
For more information, see
Section 4.7 “Configuring
security settings and
connection details” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD) and Section 5.2
“Starting services and
concluding upgrade” in
OpenText Enterprise Library -
Installation and Upgrade Guide
(EL-IGD)
Upgrade clients Clients Upgrade the Enterprise
Connect client after the
Enterprise Connect module
and the Office Editor module
are updated.
Perform post-upgrade steps SAP system • Change the logical port
in the SAP system for Content Server
Member Services from
les-services to cws.
• Update the Enterprise
Library settings to point
to the new systems. For
more information, see
“Maintaining Extended
ECM connections”
on page 114.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 73
ERLK160200-00-IGD-EN-05
Chapter 13 Upgrading from ECMLink 10.5.1 with Content Server 10.5 to Extended ECM for
SAP Solutions 16.2

Step System and Tools Information


If the connection test on SAP system Do one of the following:
Content Server does not • Create a new web service
work, configure the Service binding in the
Provider Interface again. SOAMANAGER and
switch all the connections
on Content Server side to
use the new binding.
• Delete the old web service
binding and create a new
web service binding in the
SOAMANAGER with the
same settings as before.
Changes on Content
Server are not necessary.
For more information, see
“Configuring the Service
Provider Interface service”
on page 113.

Also recreate the logical ports


and activate them. For more
information, see “Creating
logical ports in the SAP
system” on page 95
Perform post-installation SAP system Perform the remaining post-
steps installation steps. For more
information, see “Post-
installation and post-upgrade
tasks” on page 83.
Verify the installation SAP system Run the Diagnostics
Program. For more
information, see
“Understanding the SAP
Diagnostic Program”
on page 135.

13.2 Upgrading the database schema


The current version of the Connected Workspaces module changes database tables.

The database schema is upgraded with the standard Content Server mechanism.
When an upgrade is necessary, you are prompted accordingly and can upgrade the
database.

Note: You can monitor the database schema upgrade in a separate log file. This
log file is created in the logs directory of Content Server during the upgrade:
ECMLinkDBSchemaUpgrade_<threadID>.log. It logs all SQL statements of the
upgrade.

74 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
13.3. Upgrading to Extended ECM for SAP Solutions in the SAP system

Important
Make sure that you installed the latest patch of Connected Workspaces
before you upgrade the database schema.

13.3 Upgrading to Extended ECM for SAP Solutions in


the SAP system
Note: After the previous steps, you can still work with the old version in the
SAP system. So you can move the upgrade of Extended ECM for SAP Solutions
in the SAP system to a later maintenance window.
• If you want to migrate to S/4HANA which is supported by OpenText Extended
ECM for SAP Solutions 16, see the respective SAP documentation for information
about all relevant prerequisites and steps.
• Install all required SAP Notes. For more information, see “SAP system
requirements” on page 13.
• Install the relevant packages for Archiving and Document Access for SAP
Solutions 16.2 with the SAINT tool.
• Install the relevant packages for OpenText Extended ECM for SAP Solutions 16.2
with the SAINT tool. For more information, see “Installation procedure on
Content Server” on page 29.
• In the IMG, go to the Maintain Extended ECM Connections activity and change
the External System ID from the old connection to the new connection. For more
information, see “Maintaining Extended ECM connections” on page 114.
Ensure that for the HTTP connection to OTDS, the option Send SAP Logon
Ticket is selected. For more information, see “Creating logical ports for SAP
Basis 7.0” on page 95.
• Activate the BC sets. For more information, see “Installing the SAP package“
on page 23.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 75
ERLK160200-00-IGD-EN-05
Chapter 14
Upgrading from ECMLink 10.0.3, 10.0.4, or 10.5.0

For an upgrade from ECMLink 10.0.3 or 10.0.4 on Content Server 10 first upgrade to
ECMLink 10.0.5 and then to Extended ECM for SAP Solutions 16. For an upgrade
from ECMLink 10.5.0 on Content Server 10.5, first upgrade to ECMLink 10.5.1 and
then to Extended ECM for SAP Solutions 16. To perform the upgrade refer to this
guide for version 10.5.1 and the guides for related components.

After this, perform the upgrade as described above.

Note: Contact your OpenText consultant for planning your individual upgrade
strategy.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 77
ERLK160200-00-IGD-EN-05
Chapter 15
Upgrading from ECMLink 9.8.x, 10.0, or 10.0 SP1 or
SP2

For an upgrade from version of ECMLink 9.8.x, 10.0.0, 10.0.0 SP1, or 10.0.0 SP2 first
upgrade to ECMLink 10.0.3, then to ECMLink 10.5.1 and then to Extended ECM for
SAP Solutions 16. To perform the upgrade refer to this guide for version 10.0.2 and
the guides for related components.

After this, perform the upgrade as described above.

Note: Contact your OpenText consultant for planning your individual upgrade
strategy.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 79
ERLK160200-00-IGD-EN-05
Chapter 16
Upgrading from versions prior to 9.8

There is no direct upgrade from any of the following previous OTEXRL add-on
versions:
• Livelink ECM - Records Management for SAP Solutions 9.6.0
• Open Text Extended ECM for SAP Solutions 9.6.1
• Open Text - RMLink for SAP Solutions 9.7.0

If one of these older versions is already installed on your SAP system, you have to
follow an upgrade path which leads you to version 10.0.3 before further upgrade to
the newest version.
Depending on the original version you start from, there may be SAP system
upgrades required.

Note: Contact your OpenText consultant for planning your individual upgrade
strategy.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 81
ERLK160200-00-IGD-EN-05
Part 3
Post-installation and post-upgrade tasks
Part 3 Post-installation and post-upgrade tasks

This part explains the tasks that you perform after the installation.
• “Performing general post-installation tasks in SAP“ on page 85
• “Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP SRM
7.0“ on page 91
• “Performing post-installation or post-upgrade tasks in Content Server“
on page 121
• “Verifying the installation“ on page 135

84 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 17
Performing general post-installation tasks in SAP

Before using the Extended ECM for SAP Solutions functions, you have to perform a
series of post-installation and customizing tasks in SAP:
• “Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP SRM
7.0“ on page 91

Apart from the general guide to the IMG function, the following generic task is
covered in the following:
• “Assigning SAP roles”

Note: For information on the scenario-specific post-installation tasks, see


OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).

17.1 Using the IMG function


Extended ECM for SAP Solutions provides a central customizing menu in SAP in the
OpenText Extended ECM for SAP Solutions structure of SAP’s Customizing
Implementation Guide (IMG) function.

To call the IMG:

1. Start the SPRO transaction.

2. Click SAP Reference IMG.

3. Navigate to the OpenText Extended ECM for SAP Solutions structure and
open it.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 85
ERLK160200-00-IGD-EN-05
Chapter 17 Performing general post-installation tasks in SAP

4. Select the required activity and click Execute.

If an SAP system displays a different IMG structure rather than standard reference
IMG, the Extended ECM for SAP Solutions customizing is not visible. You have the
following options to access the Extended ECM for SAP Solutions customizing
structure:
• Use transaction SIMGH, save the Extended ECM for SAP Solutions IMG structure
as a favorite and call it from there.
• Add the Extended ECM for SAP Solutions customizing to the existing
customizing structure of transaction SPRO.

To use transaction SIMGH to access Extended ECM for SAP Solutions


customizing:

1. Start the SIMGH transaction.

2. In the IMG structure field, open the search help and search for the search term
OpenText*. With this search term, you also find IMG structures for other
OpenText products.

3. Double-click on entry.

4. Click Add to Favorites.

5. In the Favorites list, select one entry and click to access the IMG structure.

86 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
17.1. Using the IMG function

To add the IMG structure to SPRO transaction:

1. Create an enhancement ID:

a. Start the S_IMG_EXTENSION transaction.


b. Open the search help of field Enhancement ID.
c. Click Create Enhancement ID (F5).
d. Enter an Enhancement ID, for example Z_OTX_EXTECM, and an
explanatory text, for example OpenText Extended ECM.
e. Click Save.
f. Click Continue.
g. Double-click the newly created enhancement ID in the Enhancement ID:
Original list to select it for the Enhancement ID field.

2. Enhance the SAP IMG structure for Extended ECM for SAP Solutions:

a. In the IMG structure field, select the IMG structure that is currently
displayed in the SPRO transaction and which you want to enhance.
For example, in SAP Extended Warehouse Management, select the IMG
structure SAP - Implementation Guide.
b. Click Favorite to add the IMG structure to your favorites.
c. Select the IMG structure in the Favorites list by double clicking.
d. If not already done, in field Enhancement ID, select the enhancement ID
created in Step 1.
e. Click Enhance Structure.
f. Select the root node of the IMG structure.
g. From the menu, select Edit > Nodes > Insert IMG Structure > As Subnode.
h. Enter the node name for the customizing, for example OpenText Extended
ECM for SAP Solutions.
i. Click Find structure to search for the Extended ECM for SAP Solutions
customizing IMG structure. Search for OpenText - Extended ECM for SAP
Solutions.
j. Click Copy.
k. Click Save.

3. Enhance the SAP IMG structure for Archiving and Document Access:
Repeat the steps described in Step 2 for the OpenText Archiving and Document
Access customizing with the corresponding data:

• Name of the node: OpenText Archiving and Document Access for SAP
Solutions
• Name of the IMG structure: OpenText Archiving and Document Access for
SAP Solutions

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 87
ERLK160200-00-IGD-EN-05
Chapter 17 Performing general post-installation tasks in SAP

17.2 Assigning SAP roles


In order to use the Extended ECM for SAP Solutions functions in SAP, you must
assign specific roles in SAP. The following roles are required:

Notes
• If you do not want to use these roles, you must assign the respective
authorization objects to your own roles.
• If you want to use field values other than those recommend here, field help
provides additional information.

/OTX/RM_USER
Role for Extended ECM for SAP Solutions application users. This role allows an
SAP user declare ArchiveLink documents as records, search Content Server,
display a business workspace in the Business Content window, and show record
details.
This role contains the following authorizations objects:

Authorization object Description


/OTX/RM Records management authorizations in
GOS
Set field /OTX/RMACT to value 00 or * for
granting access to functionality related to
Records Management.
J_6NRL_DOL Business attachments authorizations
Set field /OTX/RMDAC to value 00 for
granting access to business-attachments-
related functionality.
J_6NRL_WSC Business workspace authorizations
Set field /OTX/RMWAC to value 00 for
granting access to business-workspace-
related functionality.
J_6NRL_LFS Access to local Tempo Box folder and
other local folders
Set field /OTX/RMLAC to value 00 for
granting access to local files
S_GUI Access to Drag & Drop functionality in
Business Content window.
Set field ACTVT to value 60 for granting
access to drag and drop.

/OTX/RM_ADMIN
Role for SAP administrator; this role allows for the post-installation and
customizing steps as well as administrative tasks like monitoring or running
batch jobs.

88 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
17.2. Assigning SAP roles

This role contains the following authorizations objects:

Authorization object Description


/OTX/RM Records management authorizations in
GOS
J_6NRL_DOL Business attachments authorizations
J_6NRL_WSC Business workspace authorizations

/OTX/RM_CS_SAP_USER
Role for the SAP system connection between Content Server and the SAP
system. This role is needed for the SAP user which is configured in Content
Server for the connection to SAP. For more information, see “Connecting SAP as
the business application” on page 122.

/OTX/RM_IMPERSONATED_USER_ROLE
Role for the SAP user which is used in the RFC destination. For more
information, see Section 6.7.1 “Enabling user-specific impersonation (SAP
BAdI)” in OpenText Extended ECM for SAP Solutions - User Management and
Access Control Scenarios (ERLK-CUM).

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 89
ERLK160200-00-IGD-EN-05
Chapter 18
Performing post-installation tasks for SAP ERP 6.0,
SAP CRM 7.0, and SAP SRM 7.0

18.1 Exporting the SAP PSE certificate for the SAP


authentication handler
You need the SAP PSE certificate to create the SAP authentication handler in
OpenText Directory Services. The SAP authentication handler validates SAP tickets
sent from the SAP system against the exported certificate. You export the certificate
in a PSE file from SAP using the Export System PSE Certificate to File System
activity in the SAP IMG.

To export the SAP PSE certificate:

1. In the IMG, navigate to the Export System PSE Certificate to File System
activity and click Execute.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 91
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

2. Open the System PSE section and check whether there is a certificate in this
folder.
If this is not the case, create a new one; for details, see SAP Help Portal (http://
help.sap.com/saphelp_nw70/helpdata/de/0e/fb993af7700577e10000000a11402f/
frameset.htm).

3. Make sure the certificate's CN value in the Owner field equals to the system ID;
in this case, the value is D67.
If this is not the case, delete the current one and create a new one.

4. Click Veri. PSE. If there are more certificates available, click Yes in the message
window to add only your own certificate to the verification PSE.

5. Click Yes and copy the PSE file to an appropriate location on the Directory
Services server.

92 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.1. Exporting the SAP PSE certificate for the SAP authentication handler

Only if you want to use SAP SRM you must export the SAP certificate from an SAP
SRM portal.

To export the SAP PSE certificate from an SAP SRM Portal:

In addition to the SAP server certificate, you must export a certificate for the portal.

1. Log in to the SAP SRM Portal as Portal Administrator.


2. On the System Administration tab, go to System Configuration > Keystore
Administration.
3. From the list, select SAPLogonTicketKeypair-cert.
4. Click Download verify.pse File and save the file to your desktop.
5. Unzip the downloaded file. Optionally, you can rename it to your system name,
for example <systemname>.pse.

Creating an SAP authentication handler in Directory Services


The SAP authentication handler validates the user against the SAP PSE certificate
and extracts user information from the SAP logon ticket. This is relevant for
synchronized and non-synchronized partitions. You create the respective
authentication handler using the Directory Services Administration web client.

Note: For a detailed description of authentication handlers, see Section 4.2


“Creating an authentication handler” in OpenText Directory Services - Installation
and Administration Guide (OTDS-IWC).

To create an SAP authentication handler:

1. Start Directory Services Administration in a web browser. Open http://


<fully_qualified_domain_name_of_server>:<port_number/otds-admin/
and sign in as otadmin@otds.admin.
2. On the Directory Services Administration menu, click Authentication
Handlers.
3. Click Add.
4. In the New Authentication Handler assistant, define the following settings:

• On the General page, set the Authentication handler type to SAPSSOEXT


Authentication Handler and enter a name. Click Next.
• On the User Partition page, set the scope to Global only if the user name
exists only once across all partitions. If the user exists in more than one
partition, specify the partition in the User Partition field. Click Next.
• On the Parameters page, set the following parameters:

• In the SAP Certificate (PSE) 1 field, add the certificate you exported
from SAP, and, optionally, provide a password. You can add additional

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 93
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

certificates if necessary. The Description field is automatically filled with


the path to the certificate; you can change the text.
• Only if you want to map all SAP users to one user in Content Server
according to the scenario described in Section 4.2.3.4 “Mapping all SAP
users to one OTDS user in OTDS SAPSSOEXT authentication handler” in
OpenText Extended ECM for SAP Solutions - User Management and Access
Control Scenarios (ERLK-CUM), in the Map all SAP users to field, enter
the name of the OTDS user name to which all authenticated SAP users
will be mapped once their logon ticket is verified. Use the same format
that you define in the Authentication principal attribute field.
• On the Configuration page, set the following parameters:

• Select Enable authentication handler.


• Set Priority to 1. This setting defines that this authentication handler is
used first before the other authentication handlers.
• From the list box, select an attribute that will uniquely find a given user
in Directory Services. Enter the attribute that complies to the SAP user ID
which is sent with the SAP logon ticket, for example oTExternalID or
oTExtraAttr1. Typically, this is oTExternalID1.
Click Add to add the attribute to the Authentication principal attribute
list.

5. Click Save.

18.2 Activating the SSO HTTP service


You must activate the HTTP service to use the Single sign-on (SSO) service.

Note: Make sure that the SSO profile parameters of your SAP system are set to
the following values:
login/accept_sso2_ticket = 1 for the Web Service communication between
SAP and Content Server.
login/create_sso2_ticket = 2 for the display of Content Server HTML
dialogs in SAP GUI.

For a temporary setting, start the RZ11 transaction, enter the parameter name
and click Display. For a permanent setting, use the RZ10 transaction, and
restart the system after setting the parameter.

To activate the HTTP service:

1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Activate HTTP Service activity and click Execute.

2. In the Hierarchy Type field, select SERVICE and click Execute.

3. In the Maintain service dialog, open the following node default_host > sap >
public.

94 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

4. From the context menu of the myssocntl item, select Activate Service.

18.3 Creating logical ports in the SAP system


Extended ECM for SAP Solutions connects to OpenText web services using logical
ports. The creation of logical ports differs depending on the SAP Basis version that
your system uses.

18.3.1 Creating logical ports for SAP Basis 7.0


Extended ECM for SAP Solutions connects to OpenText components using HTTP
connections and logical ports.

You must create the following HTTP connections to the required web services:
• Enterprise Library
• Extended ECM
• OpenText Directory Services
• Enterprise Library Content Services

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 95
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

• Content Server Member Services

To create the HTTP connections:

1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create HTTP Connections activity and click Execute.

2. Click Create.

3. Enterprise Library Services


Create the HTTP connection for Enterprise Library Services with the following
settings:

• RFC Destination
Enter a name for this connection, for example ELS_DEST_CORE.
• Connection Type
G (HTTP Connection to External Server)
• Description
Enter a descriptive text.

4. Click Save.

5. Customize the connection:

• Technical Settings tab


Target host: Fully qualified host name of your Enterprise Library Services
installation

96 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

Service No.: Enterprise Library Web Services port; port 8080 is typically
used for Apache Tomcat.
Path Prefix: /ot-elib/services/EnterpriseLibrary
• Logon & Security tab
The options No Logon and Send SAP Logon Ticket must be enabled.
See also SAP_BASIS component with a version higher than 16 on page 99.

6. Click Connection Test.

7. Check that the value in the Status HTTP Response field is 200 which indicates
that the request was successful.

8. Save your settings.

9. Repeat steps 2 to 7 and create more HTTP connections according to the


following table:

Enterprise Extended OpenText Enterprise Content


Library ECM Directory Library Server
Services Services Content Member
Services Service
RFC Enter a name Enter a Enter a Enter a Enter a
Destination for this name, for name, for name, for name, for
connection, example example example example
for example EXTECM_DE OTDS_DEST. ELCONTENT CSMEMBER_
ELS_DEST_ ST. _DEST. DEST.
CORE.
Connections G (HTTP G (HTTP G (HTTP G (HTTP G (HTTP
Type Connection Connection Connection Connection Connection
to External to External to External to External to External
Server) Server) Server) Server) Server)
Technical Settings tab

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 97
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

Enterprise Extended OpenText Enterprise Content


Library ECM Directory Library Server
Services Services Content Member
Services Service
Target host Fully Host name Target host: Host name Host name
qualified of your Host name of the of the
host name of Extended of your Enterprise Content
your ECM Directory Library Server
Enterprise installation Services Services installation.
Library (OTDS) installation.
Services installation.
installation If you are
using user-
specific
mapping
with
impersonati
on (SAP
BAdI) and
OpenText
Directory
Services and
Enterprise
Library
Services and
Content
Server are
installed on
different
servers,
enter the
host name of
the
Enterprise
Library
Services
installation.
Service No. Enterprise Extended Directory Enterprise Content
Library Web ECM Web Services Library Server
Services Services port Web Content Member
port; port Services port Services port Services port
8080 is
typically
used for
Apache
Tomcat.
Path Prefix /ot-elib/ / /ot- /ot-elib/ /cws/
services/ otsapxecm authws/ services/ services/
Enterpris / services/ Content MemberSer
eLibrary services/ Authentic vice
ECMLink ation

98 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

The following settings are the same for all ports:

• On the Logon & Security tab, select No Logon and Send SAP Logon Ticket.
• On the Messaging tab, in the Message ID Protocol field, select the Suppress
ID Transfer value.

SAP_BASIS component with a version higher than 16

If you are using a SAP_BASIS component with a version higher than 16, you
might experience the following changes:

The Send SAP Logon Ticket is now called Send SAP Assertion Ticket and
you must provide as destination system the system ID and the client of the
current SAP system.

If this is the case, you must also do the following:


• Ensure that the latest sapssoext.dll file is in the Tomcat\bin directory.
• Set the following system wide environment variables with the same
values that you specified in SAP:
• SAPSYSTEMNAME
• SAPSYSTEMCLIENT

After creating the HTTP connection, you must create a corresponding logical port
for each connection:
• Enterprise Library logical port
• Extended ECM logical port
• OpenText Directory Services logical port
• Enterprise Library Content Services logical port
• Content Server Member Services

To create a logical port for SAP Basis 7.0:

1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity and click Execute.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 99
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

2. Enterprise Library
In the Proxy Class field, enter /OTX/CO_RMELENTERPRISE_LIBRARY.

3. Enter a new name in the Logical Port field, for example ELS_LOGICAL_PORT.

4. Select the Default Port check box. Select it for your main Content Server if you
have more than one.

5. Click Create.

100 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

6. Enter a description for the logical port in the Description field.


On the Call Parameters tab, enter your new HTTP destination created before for
the Enterprise Library in the HTTP Destination field, for example
ELS_DEST_CORE.

7. Click Check to check the new logical port.


Check that the message in the status bar reads No errors found in
configuration.
8. Click Save and Activate (Ctrl + F3) to activate the logical port.
9. Extended ECM
Repeat steps 2 to 8 to create a logical port for Extended ECM using the
following values:

• Proxy Class
Enter /OTX/CO_RM_WSW_ECMLINK.
• Logical Port
Enter the name of the logical port, for example ECMLINK_LOGICAL_PORT.
• HTTP Destination
Enter the HTTP destination created before, for example ECMLINK_DEST.
10. OpenText Directory Services
Repeat steps 2 to 8 to create a logical port for OpenText Directory Services using
the following values:

• Proxy Class
Enter /OTX/CO_OTDSAUTHENTICATION.
• Logical Port
Enter the name of the logical port, for example OTDS_LOGICAL_PORT
• HTTP Destination
Enter the HTTP destination created before, for example OTDS_DEST.
• State Management
Select this option for the OpenText Directory Services web service. If you did
not select this option, you will get an according message during the
connection check.
11. Enterprise Library Content Services
Repeat steps 2 to 8 to create a logical port for Enterprise Library Content
Services using the following values:

• Proxy Class
Enter /OTX/CO_RMELCONTENT.
• Logical Port

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 101
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

Enter the name of the logical port, for example ELCONTENT_LOGICAL_PORT


• HTTP Destination
Enter the HTTP destination created before, for example ELCONTENT_DEST.
• State Management
Select this option for the Enterprise Library Content Services web service. If
you did not select this option, you will get an according message during the
connection check.

12. Content Server Member Services


Optional Repeat steps 2 to 8 to create a logical port for Content Server Member
Services using the following values:

• Proxy Class
Enter /OTX/CO_MBLLMEMBER_SERVICE.
• Logical Port
Enter the name of the logical port, for example CSMEMBER_LOGICAL_PORT
• HTTP Destination
Enter the HTTP destination created before, for example CSMEMBER_DEST.
• State Management
Select this option for the Content Server Member Services web service.
If you did not select this option, you will get an according message during
the connection check.

18.3.2 Creating logical ports for SAP Basis 7.01


Extended ECM for SAP Solutions connects to OpenText components using logical
ports.

You must create a corresponding logical port for each connection:

• Enterprise Library
• Extended ECM
• OpenText Directory Services
• Enterprise Library Content Services
• Content Server Member Services

To create a logical port for SAP Basis 7.01 and higher:

1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity and click Execute.
The SOA Management dialog opens.

102 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

2. On the Application and Scenario Communication tab, click Single Service


Administration.

3. On the Search tab, change the Search by value to Consumer Proxy, enter a * in
the Search Pattern field, and click Go.

4. In the Search Results pane, select the entry for EnterpriseLibrary (/OTX/
CO_RMELENTERPRISE_LIBRARY) and click Apply Selection.

5. On the Configurations tab, click Create Logical Port.

6. Enter a new name in the Logical Port Name field and add a description.
Select Logical Port is Default if you have only one logical port for the Enterprise
Library Services. If you have multiple logical ports for Enterprise Library
Services, select this option only for one of the logical ports.
For the Configuration Type, select Manual Configuration.

7. Click Apply Settings. The Web Service Configuration of Proxy Definition


section is displayed.

8. Open the Consumer Security tab and select SAP Authentication Assertion
Ticket.

9. Open the Messaging tab.


In the Message ID Protocol field, select the Suppress ID Transfer value.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 103
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

10. Open the Transport settings tab and enter the following parameters:

• URL Access Path:


/ot-elib/services/EnterpriseLibrary

• Computer Name of Access URL:


Enterprise Library Services installation host name
• Port Number of Access URL: Enterprise Library Web Services port (usually
8080 for Tomcat)

Click Save.
A message at the top of the screen indicates that the binding has been created.

11. Create the other logical ports according to the following table. If not indicated
otherwise, use the settings as described for the Enterprise Library port.

Enterprise Extended Authenticati Enterprise Content


Library ECM on Library Server
Content Member
Services Service
Internal /OTX/ /OTX/ /OTX/ /OTX/ /OTX/
name CO_RMELEN CO_RM_WSW CO_OTDSAU CO_RMELCO CO_MBLLME
TERPRISE_ _ECMLINK THENTICAT NTENT MBER_SERV
LIBRARY ION ICE
URL Access /ot-elib/ / /ot- /ot-elib/ /cws/
Path services/ otsapxecm authws/ services/ services/
Enterpris / services/ Content MemberSer
eLibrary services/ Authentic vice
ECMLink ation

104 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

Enterprise Extended Authenticati Enterprise Content


Library ECM on Library Server
Content Member
Services Service
Computer Enterprise Host name Computer Host name Host name
Name Library of your Name of of your of your
Access URL Services Extended Access URL Enterprise Content
installation ECM on the Library Server
host name installation Transport Content Member
settings tab: Services Service
Host name installation. installation.
of your
Directory
Services
installation.
If you are
using user-
specific
mapping
with
impersonati
on (SAP
BAdI) and
OpenText
Directory
Services and
Enterprise
Library
Services and
Content
Server are
installed on
different
servers,
enter the
host name of
the
Enterprise
Library
Services
installation.

The following settings are the same for all ports:

• On the Consumer Security tab, select SAP Authentication Assertion Ticket.


• On the Messaging tab, in the Message ID Protocol field, select the Suppress
ID Transfer value.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 105
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

18.3.3 Creating logical ports for SAP Basis 7.31


Extended ECM for SAP Solutions connects to OpenText components using logical
ports.

You must create a corresponding logical port for each connection:

• Enterprise Library
• Extended ECM
• OpenText Directory Services
• Enterprise Library Content Services
• Content Server Member Services

To create a logical port for SAP Basis 7.31:

1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity and click Execute.

2. In SOA Management, on the Service Administration tab, click Web Service


Configuration.

3. On the Design Time Object Search tab, select the search criteria Object Type
and search for Consumer Proxy.

4. In the Search Results list, select the entry for EnterpriseLibrary (/OTX/
CO_RMELENTERPRISE_LIBRARY).

5. On the Configurations tab, click Create > Manual Configuration.

6. In the Logical Port Name step, enter a new name in the Logical Port Name field
and add a description.
Select Logical Port is Default if this is the only logical port for Enterprise
Library Services or if this is the preferred port of several logical ports for
Enterprise Library Services. Click Next.

106 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

7. In the Consumer Security step, select SAP Authentication Assertion Ticket.


Click Next.

8. In the HTTP Settings step, configure at least the following:

• URL Access Path:


/ot-elib/services/EnterpriseLibrary
• Computer Name of Access URL:
Enterprise Library Services installation host name
• Port Number of Access URL: Enterprise Library Web Services port (usually
8080 for Tomcat)
• Transport Binding Type: SOAP1.1

Click Next.

9. In the SOAP Protocol step, set the Message ID Protocol option to Suppress ID
Transfer

Click Next.

10. In the Operation specific step, select the GetObjects operation.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 107
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

Click Finish.
The new logical port is saved and activated.

11. Repeat Step 4 to Step 10 to create a logical ports according the following table:

Extended ECM Authentication Enterprise Content Server


Library Member
Content Service
Services (MemberServic
(Content) e)
Internal name /OTX/ /OTX/ /OTX/ /OTX/
CO_RM_WSW_ CO_OTDSAUT CO_RMELCON CO_MBLLME
ECMLINK HENTICATIO TENT MBER_SERVIC
N E
URL Access /otsapxecm/ /ot-authws/ /ot-elib/ /cws/services/
Path services/ services/ services/ MemberService
ECMLink Authentication Content

108 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

Extended ECM Authentication Enterprise Content Server


Library Member
Content Service
Services (MemberServic
(Content) e)
Computer Host name of Host name of Host name of Host name of
Name of your Extended your Directory your Enterprise your Content
Access URL ECM Services Library Content Server Member
installation installation. If Services Service
you are using installation installation
user-specific
mapping with
impersonation
(SAP BAdI),
and OpenText
Directory
Services,
Enterprise
Library Services
and Content
Server are
installed on
different
servers, enter
the host name
of the
Enterprise
Library Services
installation.
Port Number of Extended ECM Directory Enterprise Content Server
Access URL Web Services Services Web Library Content Member Service
port, usually Services port , Services port, port, usually
8080 for Tomcat usually 8080 usually 8080 for 8080 for Tomcat
for Tomcat Tomcat

The following settings are the same for all ports:

• Consumer Security: SAP Authentication Assertion Ticket


• Transport Binding Type: SOAP1.1
• Message ID Protocol: Suppress ID Transfer

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 109
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

18.3.4 Creating logical ports for SAP Basis 7.51


Extended ECM for SAP Solutions connects to OpenText components using logical
ports.

You must create a corresponding logical port for each connection:

• Enterprise Library
• Extended ECM
• OpenText Directory Services
• Enterprise Library Content Services
• Content Server Member Services

To create a logical port for SAP Basis 7.51:

1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity and click Execute.

2. In SOA Management, on the Service Administration tab, click Web Service


Configuration.

3. On the Design Time Object Search tab, select the search criteria Object Type
and search for Consumer Proxy.

4. In the Search Results list, select the entry for EnterpriseLibrary (/OTX/
CO_RMELENTERPRISE_LIBRARY).

110 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.3. Creating logical ports in the SAP system

5. On the Configurations tab, click Create > Manual Configuration.


6. In the Logical Port Name step, enter a new name in the Logical Port Name field
and add a description.
Select Logical Port is Default if this is the only logical port for Enterprise
Library Services or if this is the preferred port of several logical ports for
Enterprise Library Services. Click Next.

7. In the Consumer Security step, select SAP Authentication Assertion Ticket.


Click Next.

8. In the HTTP Settings step, configure at least the following:

• URL Access Path:


/ot-elib/services/EnterpriseLibrary
• Computer Name of Access URL:
Enterprise Library Services installation host name
• Port Number of Access URL: Enterprise Library Web Services port (usually
8080 for Tomcat)
• Transport Binding Type: SOAP1.1

Click Next.

9. In the SOAP Protocol step, set the Message ID Protocol option to Suppress ID
Transfer
Click Next.

10. Click Finish.


The new logical port is saved and activated.

11. Repeat Step 4 to Step 10 to create a logical ports according the following table:

Extended ECM Authentication Enterprise Content Server


Library Member
Content Service
Services (MemberServic
(Content) e)
Internal name /OTX/ /OTX/ /OTX/ /OTX/
CO_RM_WSW_ CO_OTDSAUT CO_RMELCON CO_MBLLME
ECMLINK HENTICATIO TENT MBER_SERVIC
N E
URL Access /otsapxecm/ /ot-authws/ /ot-elib/ /cws/services/
Path services/ services/ services/ MemberService
ECMLink Authentication Content

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 111
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

Extended ECM Authentication Enterprise Content Server


Library Member
Content Service
Services (MemberServic
(Content) e)
Computer Host name of Host name of Host name of Host name of
Name of your Extended your Directory your Enterprise your Content
Access URL ECM Services Library Content Server Member
installation installation. If Services Service
you are using installation installation
user-specific
mapping with
impersonation
(SAP BAdI),
and OpenText
Directory
Services,
Enterprise
Library Services
and Content
Server are
installed on
different
servers, enter
the host name
of the
Enterprise
Library Services
installation.
Port Number of Extended ECM Directory Enterprise Content Server
Access URL Web Services Services Web Library Content Member Service
port, usually Services port , Services port, port, usually
8080 for Tomcat usually 8080 usually 8080 for 8080 for Tomcat
for Tomcat Tomcat

The following settings are the same for all ports:

• Consumer Security: SAP Authentication Assertion Ticket


• Transport Binding Type: SOAP1.1
• Message ID Protocol: Suppress ID Transfer

112 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.4. Configuring the Service Provider Interface service

18.4 Configuring the Service Provider Interface


service
For communication from Content Server to the SAP system a web service is used.
You configure the web service on SAP side. Content Server uses this web service to
connect to the SAP system.

Note: This activity is required to connect the SAP system as business


application in Content Server. For more information, see “Connecting SAP as
the business application” on page 122.

1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure structure and open it.

2. For the Configure SPI Service activity, click Execute.


The SOA Manager opens in a web browser.

Note: In the SOA Manager, the option names differ from release to
release. The following steps cover some of the possible option names. For
detailed information, see the SAP documentation.

3. Click the Business Administration, Business Administrator or Service


Administration tab.

4. Click the Web Service Administration or Single Service Configuration link to


manage the web service.

5. Search for the /OTX/ECMLINKSERVICE web service to display details.

6. Select the web service and click Apply Selection.

7. Click the Configurations tab.

8. To create a service and an end point, click Create Service.

9. Enter the following:

• New Service Name or Web Service Name: Enter a name of your web
service, for example ECMLinkSPIService.
• Description: Enter a description for your web service.
• New Binding Name: Enter a binding of your web service, for example
BasicAuthBinding.

Note: The information you enter here will be part of the address used to
access the SAP system from Content Server:

https://<common url:port/sap/bc/srt/xip/otx/ecmlinkservice/
<Client>/<WebServiceName>/<BindingName>

Example:

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 113
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

https://mucr3d6v.example.net:8443/sap/bc/srt/xip/otx/
ecmlinkservice/800/ecmlinkspiservice/basicauthbinding

10. Click Apply Settings to save.

11. To configure your web service and binding, select your web service and end
point in the table and click Edit.

12. Define the security and authentication settings. The following authentication
scenario is supported:

• HTTPS and HTTP basic authentication with user and password


On the Provider security tab, enter the following:

• Transport Guarantee Type: Select HTTPS.

Note: For HTTPS, the SSL certificate must be imported to the


keystore. For more information, see “Importing root certificates for
Secure Sockets Layer (SSL) connections” on page 121.
• Transport Protocol or Communication Security: Select HTTP Using
Secure SSL Connection.
• HTTP Authentication or Transport Channel Authentication: Select
User ID/Password.

13. Click Save.

14. Go back to SAP GUI and start the SICF transaction.

15. In the Maintain Service dialog open the sap/bc/srt/xip/otx/


ecmlinkservice/<Client>/<WebServiceName>, for example sap/bc/srt/
xip/otx/ecmlinkservice/800/ecmlinkspiservice node and check if the
<BindingName> (for example basicauthbinding) service is activated. If not,
activate it.

18.5 Maintaining Extended ECM connections


All parameters for a connection to OpenText servers are collected with an
connection ID. For an installation, you have to create a new connection ID.

To maintain connection settings in:

1. Navigate to the Infrastructure > Maintain Extended ECM Connections activity


and click Execute.

2. Click New Entries.

114 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.5. Maintaining Extended ECM connections

3. Enter the following parameters:

Connection ID
Enter a connection ID.

Extended ECM Connections

• Description: Enter a description for the connection.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 115
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

• EL Appl. Password: Enter the Enterprise Library application password;


this application password has been defined in “Creating an Enterprise
Library application” on page 126.

Logical Ports for Web Services


Enter the names of the logical ports for the Enterprise Library, the OpenText
Directory, Extended ECM, Enterprise Library Content Services, and for the
Content Server Member Service. For more information about logical ports,
see “Creating logical ports in the SAP system” on page 95.
OpenText Directory

• Partition: Enter the OTDS partition that is used to authenticate SAP


users in Content Server, only if you are using policies and only if you
have consolidated those users in OTDS in the format user@partition.
Do not enter @ together with the partition, only the partition name.
Leave the field empty, if you do not use partitions at all.

Example: Users in your system are created using the following scheme
USER@PARTITION, for example nick@SAP_USER. In this case, here, you enter
SAP_USER.
• Impersonation RFC: If you are using impersonation, enter the RFC
destination used for impersonation. In addition, you have to implement
and activate the /OTX/RM_IMPERSONATE BAdI and perform additional
configuration tasks. You also must provide the CS Resource ID.
RFC Impersonation uses a web service for SSO: if you want to restrict
this web service to redirect to a certain Content Server, you can maintain
a whitelist. For more information, see “Improving data security for
impersonation connections” on page 118.
• For more information about implementation, see the Extended ECM for
SAP Solutions SDK on OpenText My Support.
For more information about the impersonation scenario and relevant
configuration, see Section 6.7.1 “Enabling user-specific impersonation
(SAP BAdI)” in OpenText Extended ECM for SAP Solutions - User
Management and Access Control Scenarios (ERLK-CUM).

OpenText Content Server

• Protocol, Hostname, Port, and Path: These URL parameters define how
to display the Content Server Web UI. Enter the parameters for your
Content Server.
If you are using a Remote Cache Server, enter the hostname of the
primary Content Server. For Remote Cache, the IP range must be
configured, which will then redirect the HTTP request to the configured
Remote Cache Server.

Important
You must enter the full Content Server path including the
domain name.

116 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.5. Maintaining Extended ECM connections

Example:

• Protocol: http
• Hostname: cs.example.com
• Port: 2099
• Path: OTCS/cs.exe

Note: If this path has Integrated Windows Authentication (IWA)


enabled, there are limitations for the following features: thumbnail
view in the Business Content Window, license measurement, Content
Server search from SAP, UI Widget integration. These functions ask for
authentication if Integrated Windows Authentication is exclusively
enabled as authentication method. Workarounds are:

• Thumbnail preview: Disable the preview in IMG at Extended ECM >


Business Content Window > Business Content Window Settings.
Create a new entry with WSP_THUMBNAIL_OFF as setting name and
TRUE as value.
• License Report and search: Use a new RFC destination with a
mapping to Content Server without IWA .
• UI Widget integration: Use the native Business Content Window UI.

Alternative authentication configurations are:

• Enable the OTDS SSO authentication and disable the IIS IWA
configuration. (Recommended)
• If you need IIS IWA for all others users except SAP users, and there
is no way to use OTDS SSO, you can create a second mapping in IIS
that does not have IIS IWA, and configure that in the Extended ECM
connection settings.
• Support Directory defines the directory on Content Server where the
files for the Content Server widgets are stored, for example img. This is
only relevant if you want to use widgets and meet all prerequisites. For
more information, see Section 7 “Using the Content Server Integration
Widget” in OpenText Extended ECM for SAP Solutions - Customizing Guide
(ERLK-CGD).
• External System ID: Enter the SAP System ID.
• Logical Destination: This entry is needed for enabling the Content
Server full text search in the SAP system. Enter an existing logical
destination defined in the SM59 transaction that contains the connection
to the Content Server that is relevant for your search. transaction For
more information, see Section 25.1.2 “Customizing search templates” in
OpenText Archiving and Document Access for SAP Solutions - Scenario Guide
(ER-CCS).
• CS Resource ID: Content Server Resource ID as defined for Directory
Services. This option is necessary if you want to use impersonation with
web-based SSO. To retrieve the ID, open Administration Client; then go
to Directory Services > Resources > [Content Server entry] > Edit and

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 117
ERLK160200-00-IGD-EN-05
Chapter 18 Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0

copy the Resource identifier, for example d7c6b26b-


af12-4d87-87cd-050de0768f4a.

RFC Impersonation uses a web service for SSO: if you want to restrict this
web service to redirect to a certain Content Server, you can maintain a
whitelist. For more information, see “Improving data security for
impersonation connections” on page 118.

Suppress Sending SAP Logon Ticket


Select this option if you do not want to send the SAP Logon Ticket.

Proxy Settings for OpenText Content Server


The proxy settings define how to display the Content Server Web UI via a
proxy, for example Web Dispatcher.

• Proxy Settings Enabled: Select to enable the following proxy settings.


• Proxy Protocol, Proxy Hostname, Proxy Port: Enter the settings for the
proxy.

Example:

• Proxy Protocol: http


• Proxy Hostname: myproxy.domain.net
• Proxy Port: 80

4. Click Save.

18.6 Improving data security for impersonation


connections
If you are using impersonation with web-based SSO to call embedded Content
Server windows in SAP GUI, you can explicitly create a list of Content Servers that
are allowed for this kind of connection. This follows the SAP whitelist concept. For
more information, see the SAP Help Portal (http://help.sap.com/saphelp_nw73ehp1/
helpdata/en/ee/984daaa3834eeaa77d5edb822570f6/frameset.htm).

To create a whitelist for allowed impersonation connections:

1. Use transaction SM30 to open table /OTX/RM_THTWHITE.

2. Create an entry for each Content Server that is allowed to connect to your SAP
system:
Use Redirect URL /sap/public/otx_rmuic_sso as Whitelist Entry Type.
Provide the protocol, host name, port and an URL template.

Note: You can use the * wildcard in these fields.

118 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.7. Importing the Content Server SSL certificate

Important
You must add the wildcard at the end of the URL Template to cover all
URLs based on that template.

Example:

• Protocol of URL: HTTP


• Host Name: MYHOST.DOMAIN.NET
• Port: 80*, includes for example, port 8080
• URL Template: /OTCS/CS.EXE*

18.7 Importing the Content Server SSL certificate


To use SSL for the communication between Content Server and the SAP system, you
must import the Content Server SSL certificate into the SAP system.

Prerequisite
• You have configured the web servers for HTTPS.
• You have exported the certificate from Content Server in the Base64 format.

To import the certificate:

1. In the SAP system, start the TRUST transaction.

2. Open the SSL client SSL Client (Anonymous) node.

3. On the Certificate menu, click Import.

4. Enter the file path and select Base64.

5. Click the Add to Certificate List button and save your settings.

6. Repeat the steps for the SSL client SSL Client (Standard) node.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 119
ERLK160200-00-IGD-EN-05
Chapter 19
Performing post-installation or post-upgrade tasks
in Content Server

After the actual installation of the module, you have to perform post-installation
tasks in Content Server.

19.1 Importing root certificates for Secure Sockets


Layer (SSL) connections
To secure communication between Content Server and the business application,
OpenText strongly recommends that you use the Secure Sockets Layer (SSL)
protocol. You must install the certificates on the business application, the Tomcat
where the Extended ECM Web Services are running, and the Extended ECM for SAP
Solutions keystore. The Extended ECM for SAP Solutions keystore is located in
<Opentext home>/config/ecmlink-spi.cacerts. It contains the common root
certificates known from Java runtime.

Notes
• If you want to use self-signed certificates, you must import them to the
following keystores:
• Extended ECM keystore (C:\OPENTEXT\config\ecmlink-spi.cacerts)
• Content Server keystore (C:\OPENTEXT\jre\lib\security\cacerts)
• JRE keystore for the Tomcat web server where the Extended ECM Web
Services are running

For more information about keystores in Tomcat, see the Tomcat


documentation (http://tomcat.apache.org/tomcat-8.5-doc/ssl-howto.html).
• The certificate should be in Base64 format.

The following procedure describes how to import a certificate to the Extended ECM
keystore ecmlink-spi.cacerts.

To import a certificate:

1. Open a command prompt window.

2. To list the certificates, run the following command:

keytool -list -keystore c:\opentext\config\ecmlink-spi.cacerts -


storepass changeit

3. The key store password is changeit. To change the password, enter:

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 121
ERLK160200-00-IGD-EN-05
Chapter 19 Performing post-installation or post-upgrade tasks in Content Server

keytool -storepasswd changeit -new <KeystorePassphrase> -


keystore c:\opentext\config\ecmlink-spi.cacerts

4. To add a certificate run the following command:

<JavaHome>\bin\keytool -import
-alias <CertificateAlias>
-file <CertificateFile>
-keystore <Keystore>
-storepass <KeystorePassphrase>

Example:

C:\OPENTEXT\jre\bin\keytool
-import
-alias mycertificate
-file c:\temp\mycertificate.cer
-keystore c:\opentext\config\ecmlink-
spi.cacerts
-storepass mypassword

19.2 Connecting SAP as the business application


To connect Content Server with an SAP system, you define connection parameters
on Content Server.

To connect a business application:

1. On the global menu, click Enterprise > Extended ECM, and then click
Connections to Business Applications (External Systems).

2. Click Add Item > Business Application.

3. Specify the parameters for your business application according to the list below.

4. Click Add.

Logical System Name


Define the logical name of the business application. The name must be unique. It
cannot be longer than 32 characters. This name is used when you select the
business application in the business object type configuration.
This name must be the System ID of the SAP system or the tenant name of the
C4C system, respectively.

Note: You cannot change the name later.


SAP - The name must be the System ID of the SAP system or the tenant
name of the C4C system, respectively.

Connection Type
Select the adapter for your business application. If there is no special adapter
available, select Default WebService Adapter.

122 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.2. Connecting SAP as the business application

Licensing Model
Select the licensing model that applies to this connection. Each installed module
with a licensing model contributes to this list. Not used in Extended ECM for
SAP Solutions, instead see Section 17 “Performing license measurement” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
Enabled
Select this option to enable the configuration.

Tip: You can disable a configuration, for example, if you created it only for
testing and you do not want it to be used.

Comment
Enter a comment to give further information.
Base URL
Enter the common URL for accessing the business applications via a Web
browser. You can use this base URL when configuring business object types on
Content Server. The base URL is represented by the $BaseURL$ variable for new
business object types.
For example, https://r3d5g.example.com:8443
Application Server Endpoint
Specify the URL that will be called to obtain business object information.

Example 19-1: SAP


The following is an example for an SAP system: https://myhost.
opentext.net:8443/sap/bc/srt/xip/otx/ecmlinkservice/800/
ecmlinkspiservice/basicauthbinding

• https://myhost.opentext.net:8443: Common URL.


Port 8000 is the default HTTP port for SAP. For HTTPS the default
port is 8443.
• 800 is the client number. Replace this number with your own client
number.
• basicauthbinding is currently the only supported authentication.

Note: With using basic authentication, OpenText strongly recommends


that you to use SSL at the web server. For information about importing
certificates to the keystore, see “Importing root certificates for Secure
Sockets Layer (SSL) connections” on page 121.

Schema Version
Select the interface version.
User Name
Enter the user that is used to access business object type information from the
business application.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 123
ERLK160200-00-IGD-EN-05
Chapter 19 Performing post-installation or post-upgrade tasks in Content Server

Note: If the business application is an SAP system, in the SAP system


assign the /OTX/RM_CS_SAP_USER role to this user. This user requires
permissions for the SAP authorization object S_RFC.

Password
Specify the password of the defined user.

Test Connection
Click Test to perform a connection check to the specified business application.
After a successful check, the message Connection test to <Logical System Name>
was successful is displayed next to the button. The system ID will also be
retrieved and displayed.

Note: You can only test the connection after you have configured the SPI
service in the business application accordingly. For more information, see
“Configuring the Service Provider Interface service” on page 113.

System Name
Enter localized names for the business application if required.

Repository root folder


For a CMIS integration, select the root folder of your CMIS document structure.

Figure 19-1: SAP as the connected business application

124 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.3. Configuring the storage provider

19.3 Configuring the storage provider


The storage provider configuration connects the logical archives of Archive Center
with Content Server. Create a storage provider configuration for each logical
archive.

To configure the storage provider:

1. Switch to the Content Server Administration in a browser: ../OTCS/cs.exe?


func=admin.index
Log in as otadmin@otds.admin.

2. In the Archive Storage Provider Administration section, click Configure


Archive Storage Provider.

3. In the Archive Server field, enter the name of the Archive Center host.

4. Click Save Changes.

5. Click Upload Certificate to Archive Server. Archive Storage Provider uploads


its certificate to Archive Center automatically.

6. Click OK.

You get a message that you will need to enable the certificates in Archive Center.
You will do this in [xref to non-existent element "enablecertificate"].

19.4 Managing users


Content Server users are provided by OpenText Directory Services (OTDS). In order
to access Content Server from a SAP system, user accounts of the SAP system and
Content Server user accounts have to be mapped to each other. There are a number
of different scenarios, which are described in detail in OpenText Extended ECM for
SAP Solutions - User Management and Access Control Scenarios (ERLK-CUM).

Create the Content Server users according to your authentication scenario. For
example, for each SAP user working with Extended ECM for SAP Solutions, you can
create a Content Server user with the same user name as in SAP. Alternatively, you
can have one Content Server user for many SAP users.

For test purposes or a small number of users, this can be done manually in OpenText
Directory Services. For a large number of SAP users this can achieved using an
Active Directory server that provides users for both the SAP system and for Content
Server via Directory Services.

In your SAP system, the users are either provided and maintained in your SAP
system or in an external identity provider. Directory Services can synchronize with
your identity provider to pull user and group information from your identity
provider automatically.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 125
ERLK160200-00-IGD-EN-05
Chapter 19 Performing post-installation or post-upgrade tasks in Content Server

19.5 Preparing document declaration


The following steps are only necessary if you want to store SAP ArchiveLink
documents and print lists as documents in a defined location in Content Server.

19.5.1 Creating an Enterprise Library application


To declare records, Extended ECM for SAP Solutions needs an Enterprise Library
application. ArchiveLink documents and print lists declared as records by the SAP
system can either be stored in the Enterprise Workspace or in this application area.
To restrict access to these documents, you must set additional permissions on the
application level.

To create an application:
1. In the OpenText Administration Client, navigate within the Enterprise Library
Services to the Applications entry.
2. In the Actions pane, select the New Application entry.
3. Enter the required parameters for the application.

a. Select Delete notifications.


This is required for the /OTX/RM_REMOVE_LINKS report which deletes
orphaned links on Content Server. For more information about the report,

126 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.5. Preparing document declaration

see Section 5.5 “SAP: Scheduling jobs for removing deleted records” in
OpenText Extended ECM for SAP Solutions - Administration Guide (ERLK-
AGD).
b. In the Password field, you define an application password that is used for
“Maintaining Extended ECM connections” on page 114.

Note: OpenText recommends that the application name is identical to


the respective SAP system ID.
c. Click Next.

4. Select the required audit interests that correspond to your audit scheme and
click Finish to complete the assistant.
The new application is now displayed in the list of applications.

To set permissions for an application:

1. Go to the Content Server Administration page and select the Enterprise


Library Administration > Open the Enterprise Library Volumes entry.

2. Click the button of the application folder with the application ID you just
created and select the Permissions entry from the context menu.
The Permissions page displays.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 127
ERLK160200-00-IGD-EN-05
Chapter 19 Performing post-installation or post-upgrade tasks in Content Server

The following permissions are set as a default:

• Full access rights to the volume for the user who created the application (in
our case the user is otadmin@otds.admin).
• Only See and See Contents access rights for the groups DefaultGroup and
Public Access.

3. Add users and groups that must have access to this volume.

4. Grant full access to those users and groups that have to declare records within
SAP.

Note: If you choose to store records in Enterprise Workspace folders, set


the permissions for these folders accordingly. Users and groups that have
to declare records within SAP require full access to these folders. For more
information, see Section 6.10 “SAP: Creating an document declaration” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).

128 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.5. Preparing document declaration

19.5.2 Creating a Records Management classification


(optional)
If you want to use Records Management, you must create at least one Records
Management classification that can be used in Extended ECM for SAP Solutions.

For more information, see OpenText Classifications - Resource Guide (LLESCLS-GGD).

19.5.3 Importing folder and item type


Extended ECM for SAP Solutions stores metadata for the declared ArchiveLink
documents in the Enterprise Library volume. On the installation medium in the
Extended ECM\Content_Server folder, you find the following items:

• Item type otx.sap.rm.Document.xml


• Folder type otx.sap.rm.Folder.xml
• Item type otx.sap.rm.SystemArchiveLink.xml
• Item type otx.sap.rm.SystemPrintlist.xml

These files must be imported with the OpenText Administration Client.

To import the folder type:

1. Start the OpenText Administration Client and navigate to Enterprise Library


Services > Document Model and click the Folder Types tab.

2. In the Actions pane, select the Import Types entry and navigate to the otx.
sap.rm.Folder.xml file provided in the Extended ECM\Content_Server folder
on your installation medium. Click Open to import the file.
The list of folder types displays the new folder type.

3. Select the new folder type, invoke the Properties dialog and click the
Classification tab.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 129
ERLK160200-00-IGD-EN-05
Chapter 19 Performing post-installation or post-upgrade tasks in Content Server

4. Select the Set default classification option and click Browse to select a
classification.

To import the item type:

• In the Document Model entry, click the Item Types tab.


Repeat the above procedure for the following files:

• otx.sap.rm.Document.xml

• otx.sap.rm.SystemArchiveLink.xml

• otx.sap.rm.SystemPrintlist.xml

130 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.5. Preparing document declaration

19.5.4 Setting up the authorization for records


The access rights to the records created by Extended ECM for SAP Solutions
correspond to the access rights used by the Enterprise Library application. For more
information, see “Creating an Enterprise Library application” on page 126. In order
to restrict the access in accordance with your company policy, you have to create
Content Server groups and set the respective access rights on the classification level.

The following access rights (either directly, via a group, or via public access) are
required:
• To see records, users must have at least See Contents permission.

• To declare records, users must have at least Add Items permission.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 131
ERLK160200-00-IGD-EN-05
Chapter 19 Performing post-installation or post-upgrade tasks in Content Server

Example 19-2: Authorization for records in Content Server

Records should be created for HR and Finance department; you could now
separate the records either by storing them in different locations or by
classifying them differently. To use the classification approach, create a
Finance Content Server group and add all the users that should have access
to the Finance records; then create a similar HR group. Assign the Finance
group access rights to the Finance classification and the HR group to the HR
classification.

19.5.5 Creating system categories in Content Server


Extended ECM for SAP Solutions stores all metadata in Content Server categories
rather than using Enterprise Library item types. The imported item types otx.
sap.rm.SystemArchiveLink and otx.sap.rm.SystemPrintList can be copied to
categories described below.

You can also create system categories manually, but copying the imported item
types ensures that no mandatory category attributes are missing.

To create system categories:

1. Go to the Content Server Administration page and select the Enterprise


Library Administration > Open the Enterprise Library Types Volumes entry.

2. Browse to the folder named otx.sap.rm.SystemArchiveLink and open it.

3. Copy the category file otx.sap.rm.SystemArchiveLink.v to a different location


within the Categories volume. If required, you can change the category name.

132 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.6. For SAP CRM and SRM: Configuring security settings

Caution
Do not delete the original category file under Open the Enterprise
Library Types Volumes.

4. Repeat the above procedure with the category file otx.sap.rm.SystemPrintList.v


in the otx.sap.rm.SystemPrintList folder.

5. Create unique names for the system categories. You will need the unique name
for the document declaration configuration in the SAP IMG. For more
information, see Section 6.9 “Unique names for Content Server items” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).

19.6 For SAP CRM and SRM: Configuring security


settings
To display business workspaces in web applications of SAP CRM and SAP SRM,
you must adapt the security parameters in Content Server.

To enable display of business workspaces in web applications of SAP:

1. On the Content Server Administration page, click Server Configuration >


Configure Security Parameters.

2. Specify the following parameters:

Frame Embedding
Must be unchecked. You do not want to prevent request handlers from
being embedded in external frames.

Trusted Referring Websites


Enter the URL of the SAP application website with port, for example
http://mycrmsystem.mycompany.com:8000.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 133
ERLK160200-00-IGD-EN-05
Chapter 20
Verifying the installation

20.1 Analyzing the SAP system


20.1.1 Understanding the SAP Diagnostic Program
You can use the Diagnostic Program to analyze your installation.

Important
You can run the infrastructure diagnostic program after specifying at least
the Extended ECM connection in the Infrastructure section of the IMG.

The diagnostic program is aimed at two different target groups:


• The Infrastructure part is for technical consultants who set up the connection
between the SAP system and the OpenText servers. The report contains the
following types of information: the connection to Content Server, Web service
communication such as logical ports, the OTDS service or HTML controls.
• The Extended ECM part contains the infrastructure information in addition to
information about the customizing, like business object declarations, document
declarations, or item types.
This information only displays if you start the activity from OpenText Extended
ECM for SAP Solutions > Extended ECM > Diagnostic Program.

A green light icon indicates that everything is in order. For checks with a red light
icon, a recommendation is displayed. For more information about each check, see
“Understanding the details of the Diagnostic Program” on page 136.

Note: You can also run the Diagnostic Program as a background job.

To run the Diagnostic Program manually:

1. If you are only interested in infrastructure information, in the IMG, navigate to


the OpenText Extended ECM for SAP Solutions > Infrastructure > Diagnostic
Program and click Execute.
If you are also interested in the Extended ECM specific information, in the IMG.
navigate to the OpenText Extended ECM for SAP Solutions > Extended ECM
> Diagnostic Program activity.
2. If there is only one Extended ECM connection configured, the diagnosis is
started immediately. If there are more connections configured, perform the
following steps, enter the connection ID.
3. Click Execute.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 135
ERLK160200-00-IGD-EN-05
Chapter 20 Verifying the installation

20.1.2 Understanding the details of the Diagnostic Program


This section lists the various tests of the Diagnostic Program and refers to sections in
this guide which contain helpful information.

Test IMG Activity More Information


Content Server
Does the connection ID exist? Infrastructure > Maintain “Maintaining Extended ECM
Extended ECM connections; connections” on page 114
Did you select a proxy for double-click one entry.
Content Server?
Did you provide the Content
Server host name?
Is the Content Server host
name fully qualified?

136 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
20.1. Analyzing the SAP system

Test IMG Activity More Information


Did you provide the Content
Server port?
Did you provide the path to
Content Server?
Can the SAP system connect
to Content Server through
HTTP?

Can the SAP system connect


to the proxy through HTTP?
Service Communication
Did you provide a port for Infrastructure > Create New “Creating logical ports in the
the Enterprise Library Logical Ports SAP system” on page 95
Service?
Can the Enterprise Library
Service be instantiated?
Did you provide an HTTP Infrastructure > Create New “Creating logical ports in the
destination for the Enterprise Logical Ports SAP system” on page 95
Library logical port?
Check the following for the For SAP Basis 7.0: “Creating logical ports in the
Enterprise Library HTTP Infrastructure > Create SAP system” on page 95
connection: “No Logon” and HTTP Connections > HTTP
“Send SAP Logon Ticket” is Connections to External
enabled; “HTTP Server; double-click one
compression” is disabled. connection; Logon &
Security tab and Special
Options tab.
For SAP Basis > 7.0: “Creating logical ports for
Infrastructure > Create New SAP Basis 7.01” on page 102
Logical Ports > SOA
Management > Application
and Scenario
Communication > Single
Service Administration
Can the Enterprise Library
Service be executed?
Did you provide a port for Infrastructure > Create New “Creating logical ports in the
the Enterprise Library Logical Ports SAP system” on page 95
Content Service?
Can the Enterprise Library
Content Service be
instantiated?
Did you provide an HTTP Infrastructure > Create New
destination for the Enterprise Logical Ports
Library Content logical port?

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 137
ERLK160200-00-IGD-EN-05
Chapter 20 Verifying the installation

Test IMG Activity More Information


Check the following for the For SAP Basis 7.0: “Creating logical ports in the
Enterprise Library Content Infrastructure > Create SAP system” on page 95
connection: “No Logon” and HTTP Connections > HTTP
“Send SAP Logon Ticket” is Connections to External
enabled; “HTTP Server; double-click one
compression” is disabled. connection; Logon &
Security tab and Special
Options tab.
For SAP Basis > 7.0: “Creating logical ports for
Infrastructure > Create New SAP Basis 7.01” on page 102
Logical Ports > SOA
Management > Application
and Scenario
Communication > Single
Service Administration
Can Enterprise Library
Content Service be executed?
Did you provide a logical Infrastructure > Create New “Creating logical ports in the
port for the Content Server Logical Ports SAP system” on page 95
Member Service?
Can the Content Server
Member Service be
instantiated?
Did you provide an HTTP Infrastructure > Create New
destination for the Content Logical Ports
Server Member logical port?
Check the following for the For SAP Basis 7.0: “Creating logical ports in the
Content Server Member Infrastructure > Create SAP system” on page 95
HTTP connection: “No HTTP Connections > HTTP
Logon” and “Send SAP Connections to External
Logon Ticket” is enabled; Server; double-click one
“HTTP compression” is connection; Logon &
disabled. Security tab and Special
Options tab.
For SAP Basis > 7.0: “Creating logical ports for
Infrastructure > Create New SAP Basis 7.01” on page 102
Logical Ports > SOA
Management > Application
and Scenario
Communication > Single
Service Administration
Can the Content Server Directory Services Section 6.5 “Configuring
Member Service be executed? Administration > Access access roles” in OpenText
Roles Extended ECM for SAP
Solutions - User Management
and Access Control Scenarios
(ERLK-CUM)

138 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
20.1. Analyzing the SAP system

Test IMG Activity More Information


Did you provide a logical Infrastructure > Create New “Creating logical ports in the
port for the Extended ECM Logical Ports SAP system” on page 95
Service?
Did you provide an HTTP Infrastructure > Create New
destination for the Extended Logical Ports
ECM logical port?
Check the following for the For SAP Basis 7.0: “Creating logical ports in the
Extended ECM HTTP Infrastructure > Create SAP system” on page 95
connection: “No Logon” and HTTP Connections > HTTP
“Send SAP Logon Ticket” is Connections to External
enabled; “HTTP Server; double-click one
compression” is disabled. connection; Logon &
Security tab and Special
Options tab.
For SAP Basis > 7.0: “Creating logical ports for
Infrastructure > Create New SAP Basis 7.01” on page 102
Logical Ports > SOA
Management > Application
and Scenario
Communication > Single
Service Administration
Can the Extended ECM
Service be executed?
Did you provide a logical Infrastructure > Create New “Creating logical ports in the
port for the OTDS Service? Logical Ports SAP system” on page 95
Did you provide an HTTP Infrastructure > Create New
destination for the OTDS Logical Ports
services?
Check the following for the For SAP Basis 7.0: “Creating logical ports in the
OTDS HTTP connection: “No Infrastructure > Create SAP system” on page 95
Logon” and “Send SAP HTTP Connections > HTTP
Logon Ticket” is enabled; Connections to External
“HTTP compression” is Server; double-click one
disabled. connection; Logon &
Security tab and Special
Options tab.
For SAP Basis > 7.0: “Creating logical ports for
Infrastructure > Create New SAP Basis 7.01” on page 102
Logical Ports > SOA
Management > Application
and Scenario
Communication > Single
Service Administration
Can the OTDS Service be
executed?

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 139
ERLK160200-00-IGD-EN-05
Chapter 20 Verifying the installation

Test IMG Activity More Information


If impersonation RFC is
provided, can the
impersonation RFC be
executed?
Did you provide a service for Infrastructure > Configure “Configuring the Service
the SPI service SPI Service or Provider Interface service”
configuration? SOAMANAGER transaction on page 113
Check the following for the Infrastructure > Configure “Configuring the Service
SPI service configuration: SPI Service or Provider Interface service”
“Transport Guarantee Type = SOAMANAGER transaction on page 113
HTTPS”; “Authentication:
User ID/Password” is
enabled.
HTML Controls
Can an HTML control be
instantiated?
Can an HTML control be
initialized?
Can the HTML control
enable SSO?
Are the SAP HTTP server
and the Content Server
server in the same domain or
is the Content Server server
in a subdomain of the SAP
HTTP server domain?
>>> Double-click here to test Tests the above items and
an HTML control. <<< opens a window with
Content Server categories. It
also gives solutions for
possible problems.
Are the SAP SSO profile The following parameters “Activating the SSO HTTP
parameters set properly? must be set: login/ service” on page 94
accept_sso2_ticket = 1
and login/
create_sso2_ticket = 2

140 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
20.1. Analyzing the SAP system

20.1.3 Understanding the Configuration Report


You can use the SAP Configuration Report to summarize your Extended ECM for
SAP Solutions configuration. The report displays system and configuration
parameters coming from customizing transactions and tables. You can use this
information for reference and for debugging. You can export the list to a file.

To run the SAP Configuration Report:

1. In the IMG, navigate to the Extended ECM > Configuration Report activity and
click Execute .
The report opens. You can use standard SAP functions to view details, browse
the report, or filter separate lists in the report.

2. To save the report to a local file in, for example in HTML format or as a
spreadsheet, click Local file ..., and select the format that you want.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 141
ERLK160200-00-IGD-EN-05
Part 4
Miscellaneous
Part 4 Miscellaneous

This part contains optional configuration tasks.


• “Installing Content Server patches using the cluster management tool“
on page 145
• “Performing additional optional tasks“ on page 147
• “Preparing a checklist for the customizing team“ on page 171
• “Transporting Extended ECM for SAP Solutions Content Server configuration
and templates“ on page 173

144 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 21
Installing Content Server patches using the cluster
management tool

Update Content Server to the current patch level. You can do this using Content
Server Cluster Management, which helps you to find the required patches and
deploy them correctly. Cluster Management enforces patch dependencies and
removes superseded patches.

In some cases there are dependencies between the patch levels on the Content Server
and Web service side. The cluster management tool only provides the Content
Server side patch. For more information, see Cluster Management Patch
Deployment System (https://knowledge.opentext.com/knowledge/cs.dll/Open/
41561891) on OpenText My Support.

Note: You need a user login with access to OpenText My Support. OpenText
strongly recommends that you backup your installation and the database
before deploying the patches.

1. Go to the Content Server Administration Page (../OTCS/cs.exe?func=admin.


index).

2. Go to Server Configuration > Cluster Management.

3. Click Manage Cluster Settings and configure the cluster:

• Manifest URL: http://mimage.opentext.com/support/ecm/


contentserver/16.2/manifest_win.xml. Click Check URL to validate.

• Master System: Click Browse and select the system.


• Patch Staging Folder: C:\OPENTEXT\clustermanagement\staging.
• Download: Select Yes.

Click Save Settings.

4. Click Manage Updates

5. Select the required Content Server update and the matching patches.

6. Click Download. The patches are retrieved from OpenText My Support and
moved to the staging folder.

7. From there you can deploy them. Follow the instructions of the online help and
messages on the screen. You may want to deploy the Content Server first and
then deploy the patches. Make sure you have backed up your database and the
Content Server installation.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 145
ERLK160200-00-IGD-EN-05
Chapter 22
Performing additional optional tasks

22.1 Checking the appearance of the SAP integration


If you want to integrate the Extended ECM for SAP Solutions functionality in SAP
CRM or SAP SRM, you can adjust the Content Server appearance and use an SAP
based skin. As a standard, these settings are made automatically during the
installation of the Content Server SAP Base module.

New: You can now define a unique name for a Content Server appearance, to
make the theme mapping transportable.

After installation, unique names for standard SAP themes already exist. You can edit
these unique names and their assignment. Changes take effect immediately. The
following SAP themes are already configured: content_server, default,
sap_tradeshow, sap_tradeshow_plus. Unique names for appearances must use the
prefix theme_ and they are always expected in lower case, even if SAP sends the
parameter in upper case. For more information, see Section 6.9 “Unique names for
Content Server items” in OpenText Extended ECM for SAP Solutions - Customizing
Guide (ERLK-CGD).

To check the appearance integration:

1. In Content Server, go to the Administration page and select Appearances


Administration > Open the Appearances Volume.

2. Select the recommended appearance:


For SAP CRM: EXTENDED_ECM_CRM_DEFAULT
For SAP SRM: EXTENDED_ECM_SRM_SAP_TRADESHOW
3. Check if the following settings are present according to Figure 22-1 or
Figure 22-2.

• Current Status: Enabled


• Header section
• Content Server Components section

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 147
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

• Workspace section

Figure 22-1: Appearance settings for SAP CRM

Header script for EXTENDED_ECM_CRM_DEFAULT -

<SCRIPT ID="crm_default" TYPE="text/javascript"></SCRIPT>


<LINK ID="crm_default_css" REL="stylesheet" TYPE="text/css"/></
LINK>
<SCRIPT TYPE="text/javascript">
document.getElementById("crm_default").src = supportPath +
'otsapxecm/crm_default/crm_default.js';
document.getElementById("crm_default_css").href = supportPath +
'otsapxecm/crm_default/crm_default_style.css';
document.getElementsByTagName('body').className+='
preventFlicker';
var trunc_type = '_848';
</SCRIPT>
<STYLE>

148 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.1. Checking the appearance of the SAP integration

#pw_SideBarWrapper {display: none;}


</STYLE>

Figure 22-2: Appearance settings for SAP SRM

Header script for EXTENDED_ECM_SRM_SAP_TRADESHOW -

<SCRIPT ID="srm_sap_tradeshow" TYPE="text/javascript"></SCRIPT>


<LINK ID="srm_sap_tradeshow_css" REL="stylesheet" TYPE="text/
css"/></LINK>
<SCRIPT TYPE="text/javascript">
document.getElementById("srm_sap_tradeshow").src = supportPath +
'otsapxecm/srm_sap_tradeshow/srm_sap_tradeshow.js';
document.getElementById("srm_sap_tradeshow_css").href =
supportPath + 'otsapxecm/srm_sap_tradeshow/
srm_sap_tradeshow_style.css';
document.getElementsByTagName('body').className+='
preventFlicker';
var trunc_type = '_848';
</SCRIPT>

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 149
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

These settings will turn off certain standard Content Server UI components such
as header and footer; an additional JavaScript will be added to the appearance
to manipulate the breadcrumb navigation.

22.2 Adding your own logo to Content Server Smart


View
In Smart View, a logo is displayed after installation. By default, this is the Content
Server logo. You can also choose to display the Opentext Extended ECM logo, or
you show your own logo. A small CSS file is delivered with Extended ECM, which
contains the instruction to display a logo. The CSS file must be propagated in the
Content Server administration. For best results, the graphic file should be in SVG
format.

New: You can now display a custom logo Content Server Smart View.

You need administrator’s access to Content Server.

To configure the logo file in Smart View:

1. Open the overrides.css file in the following folder: <Content Server home>
\support\xecmpf.

150 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.2. Adding your own logo to Content Server Smart View

2. Change the path and name of the logo file in the background-image setting to
match your logo.

.binf-navbar .binf-navbar-brand > .csui-logo > .csui-logo-image {


background-image: url(header_extended_ecm.svg);
background-repeat: no-repeat;
background-size: 266px, 86px;
height: 43px;
width: 266px;
}

/* Move company logo to the left */


.binf-navbar .binf-navbar-brand .csui-logo {
position: fixed;
left: 40%;
}

You can chose from these Extended ECM logos:

• header_extended_ecm.svg

• header_extended_ecm_inv.svg

3. Optional Alternatively, you can use your own graphic file:

a. Provide name and location of the graphic file in the CSS file.
b. Copy your logo to the location you specified in the CSS file.

4. Propagate the overrides.css in Content Server:

a. On the Content Server Administration page, select Server Configuration >


Configure Smart View.
b. In the Overriding Default Style section, enter the path to your overrides.
css.
If you are using IIS as Webserver, the support folder on the Content Server
server is mapped to img folder.

• Storage location: C:\OPENTEXT\support\overrides.css


• URL path: img/overrides.css

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 151
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

22.3 Customizing the integration into SAP GUI via


Generic Object Services
22.3.1 Customizing the Generic Object Services (SAP GUI)
You can make business workspaces and business attachments available for users in
SAP GUI via Generic Object Services (GOS). The user can then create workspaces,
display existing ones and display, create and delete business attachments in SAP
GUI. For this, you customize the GOS table.

The Business Content window displays business workspaces, business attachments,


business documents, local TempoBox folders, other local files, and notes in one
dialog.

Important
If you are upgrading from 10.0.0, the existing GOS customizing will not be
changed. You can choose if you want to keep several GOS entries or if you
want to use OpenText Business Content.

Tip: For a detailed description of the Business Content window, see Section 25.2
“OpenText Business Content window” in OpenText Archiving and Document
Access for SAP Solutions - Scenario Guide (ER-CCS).

To customize General Object Services:

1. Start the SM30 transaction and enter SGOSATTR in the Table/View field. Click
Maintain.

152 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.3. Customizing the integration into SAP GUI via Generic Object Services

2. Click New Entries.

3. Customize the new entry according to the following list. The OTX_ATTACH
service displays the Business Content window: business workspaces, business
attachments and business documents (ArchiveLink documents). From the
Business Content window, users can access the complete functionality.

Name of service
Enter OTX_ATTACH.

Description
Provide a description, for example, Business Content. This description is
displayed in the GOS menu.

Quick Info
Provide a quick info, for example, Business Content. This information is
displayed for the icon.

Class for Generic Service


Enter /OTX/RM_GOS_SRV_ATTACH_LIST.

Service Type
Select Single Service .

Icon
ICON_BUSINAV_DATAMODEL

Note: Control and Commit required must remain unselected.

4. You must define the position of the new service in the General Object Services.
In the Next service field, enter the name of the service that should follow after
this service. If the service is the last, leave the field empty.

Important
If you do not define the position correctly, it might not be displayed at
all.

• You want to add the new service at the beginning of the existing services:
Enter the name of the first existing service in the Next service field of the
new service.
• You want to add the new service at the end of the existing services: Enter the
name of the new service in the Next service field of the last existing service.
Leave the Next service field of the new service empty.
• You want to add the new service in between the existing services: Enter the
name of the new service in the Next service field of the predecessor of
existing services. Enter the name of the successor existing service in the Next
service field of the new services.

5. Click Save.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 153
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

Note: For more information about maintaining the SGOSATTR table, see the SAP
documentation (https://www.sdn.sap.com/irj/scn/index?rid=/library/uuid/
a0139058-ef9d-2b10-598c-9e23dc6f44fc).

For problems when displaying services in GOS, see SAP Note 961713 -
Structure of table SGOSATTR.

22.3.2 Select items to be displayed in Business Content


window
For each business object type, you can select, which items you want to be displayed
in the Business Content window.

New: You can now customize, which items are displayed in the Business
Content window of a certain business object type.

To customize the displayed items in a Business Content window:

1. In the IMG, navigate to the Extended ECM > Business Content Window >
Maintain Business Content Window Display Options and click Execute.
2. Click New Entries.

3. Select a business object type and then select the options that you want to be
displayed:
Business workspace thumbnails
Drag and Drop in business workspaces
Business attachments
Business documents
Business documents thumbnails
Notes
Local files

Tip: For general settings of the Business Content window, which are also
placed in this dialog, see “Enabling the integration widget in the Business
Content window” on page 157.

154 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.3. Customizing the integration into SAP GUI via Generic Object Services

22.3.3 Customizing the context menu of the Business Content


window
The context menu of the Business Content window in the SAP system displays a
selection of Content Server menu entries that are available for the specific item. You
can customize the context menu as follows:

• Remove Content Server menu entries that are not relevant and add specific menu
items that are available on Content Server, for example when a new module was
installed. The added menu items are displayed in the context menu only if they
are available for the item type. For more information, see “Customizing the
Business Content window context menu with Content Server menu entries ”
on page 155.
• In addition to the available Content Server menu entries, you can add new
entries and implement custom functionality. For more information, see “Adding
custom functionality to the Business Content window context menu”
on page 157.

Note: The customizing applies only to Content Server Classic View, not if the
integration widget is used as described in “Enabling the integration widget in
the Business Content window” on page 157.

22.3.3.1 Customizing the Business Content window context menu with


Content Server menu entries
You can remove irrelevant entries from the context menu or add specific menu
items, which are also available in Content Server, for example when a new module
was installed. The context menu items are displayed in the context menu only if they
are available for the item type.

To customize the context menu with Content Server menu entries:

1. In the IMG, navigate to the Extended ECM > Business Content Window >
Maintain Business Content Window Menu and click Execute.

2. Click New Entries.

3. Enter the following:

Code ID
Enter the code ID. Use the F4 help to retrieve the code ID.

Note: If the code ID is not listed in the F4 help, retrieve it from


Content Server: In the Content Server IDE plug-in for Eclipse, go to
the WebNodeCmd object in the WEBNODE OSpace. From the context
menu of the WebNodeCmd, select Open Inheritance View. A list
with all possible context menu objects is displayed. Find the respective
object and note the name.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 155
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

BROWSE Open
COPY Copy
DELETE Delete
DOWNLOAD Download
FETCH Open
MAKEFAVORI Add to Favorites
TE
MOVE Move
PRINT Print
TEXTEDIT Edit
VIEWDOC View with Content Suite Viewer

Note: Alternatively, you can integrate Content Suite


Viewer using the SM30 transaction. This is the
recommended integration. For more information, see
“Integrating Viewers in the Business Content window”
on page 161.

Add/Remove
Click Add or Remove. When you add an entry, it is added according to the
sequence in the Content Server menu. You cannot add already existing
entries.

Description
Enter a description. This description is displayed in the context menu. You
can use && to display the & character.
If you want to add the entry in other languages, use the standard SAP
mechanism (Goto > Translation).

Example: In the following example, the new menu item Zip & Download is added to
the menu.

156 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.3. Customizing the integration into SAP GUI via Generic Object Services

22.3.3.2 Adding custom functionality to the Business Content window


context menu
In addition to the available Content Server menu entries, you can add new entries to
the context menu and implement custom-made functionality using BAdI
technology. For detailed information, see the SDK on OpenText My Support (https://
knowledge.opentext.com/knowledge/cs.dll/Open/68222307).

Adding custom functionality:

1. In the IMG, navigate to the Extended ECM > Business Content Window >
Implement Business Content Window Menu BAdI and click Execute.

2. Implement your code. For detailed information, see the sample code provided
with the BAdI definition (menu Goto > Sample Code > Display).

• The method PROCESS_CTX_MENU_CONSTRUCTION is used to create an


additional context menu entry.
• In the method PROCESS_WKSP_FCODE you can react on the function codes
you assigned to your context menu entry.

22.3.4 Providing Drag-and-drop functionality for the Business


Content window
To upload documents, users can drag files from the local file system into a business
workspace. The local files system can either be the local file explorer or the Local
Files node in the Business Content window.

To copy files, users can drag between different nodes in the Business Content
window. To download files, they drag a file to the Local Files node.

For this functionality, users must have the S_GUI authorization object with the
ACTVT=60 parameter. This authorization object is part of the /OTX/RM_USER role.

22.3.5 Enabling the integration widget in the Business Content


window
In the Business Content window, users can work with business workspaces. You can
define separately for each business object type that users see the integration widget
(Content Server Smart View) instead of the default view. Optionally, you can also
define which theme to use.

Important
If you want to use the integration widget and if you use Content Server on
Microsoft IIS, you must configure detailed errors messages on local and
remote requests. For more information, see “Configuring Microsoft IIS to
Return Meaningful REST API Error Messages” on page 158.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 157
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

To enable the integration widget (Content Server Smart View):

1. In the IMG, navigate to the Extended ECM > Maintain Business Object
Declarations activity and select Use Widgets for UI for the business objects for
which you want to enable the integration widget. For more information about
the activity, see Section 3.3 “Creating a business object declaration in SAP” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).

2. Optional To define the theme, in the IMG, navigate to the Extended ECM >
Business Content Window > Maintain Business Content Window Display
Options and click Execute.

a. In the General Settings section, click New Entries.

b. As Setting Name enter WSP_WIDGET_CSS_THEME and as Setting Value enter


the name of the theme, for example sap_bluecrystal.

Tip: For more customizing options for the Business Content window, see
“Select items to be displayed in Business Content window ” on page 154

22.3.6 Configuring Microsoft IIS to Return Meaningful REST


API Error Messages
Using the default configuration, Microsoft IIS returns a generic error message when
interfaces that are based on the Content Server REST API, such as the Content Server
Smart UI, encounter errors. Presenting a more informative error message to users
can aid in troubleshooting any difficulties that they encounter.

Example: With Detailed errors enabled, IIS returns a message similar to An item with the
name <filename.txt> already exists, but if Detailed errors is not enabled, IIS returns
only Error: Bad Request (400).

To enable Content Server to display informative error messages when problems


occur with Content Server REST API interfaces enabled using Microsoft IIS,
OpenText recommends that you enable Detailed Errors in Microsoft IIS.

To enable Detailed Errors in Microsoft IIS:

1. Open Internet Information Services (IIS) Manager.

2. On the left, expand the Content Server website, and click the Content Server
Application.

3. The default Application name is OTCS.

4. In the middle pane, double-click Error Pages.

5. On the right, under Actions, click Edit Feature Settings On the Edit Error
Pages Settings, enable Detailed errors in the Error Responses section, and then
click OK.

158 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.3. Customizing the integration into SAP GUI via Generic Object Services

22.3.7 Maintaining Content Server subtypes as copy/move


target in the Business Content window
In the Business Content window, users can copy or move documents or other items
from one location to another location in Content Server. However, if you are using
custom Case subtypes and you want to copy or move documents to these custom
Case subtypes you must do the following SAP customizing.

All Content Server items that can be targets for a copy/move operation are
maintained in the /OTX/RM_STWL table. This table is part of Extended ECM for SAP
Solutions and it is filled with a predefined set of subtypes. The new table /OTX/
RM_STWL_C is available to maintain new entries.

Important
As soon as /OTX/RM_STWL_C has one entry, the /OTX/RM_STWL is not used
anymore. If you intend to use /OTX/RM_STWL_C, you must copy the entries
of /OTX/RM_STWL into the custom table.

To maintain custom Case subtypes for copy/move operations:

1. Copy all entries from the /OTX/RM_STWL table to the Subtype column of the /
OTX/RM_STWL_C table.

a. Start transaction SE16 and open /OTX/RM_STWL.

b. Start transaction SM30 and open the maintenance view of the /OTX/
RM_STWL_C table.

c. Copy all entries from /OTX/RM_STWL into the clipboard. You can use CTRL
+ Y to copy several rows.

d. Copy the rows into the Subtype column of the /OTX/RM_STWL_C table.

e. Add the connection ID for which the subtype is valid.

2. Add a new entry for your new Case subtype:

• Conn. ID: Connection ID. You find this information in the IMG > OpenText
Extended ECM for SAP Solutions > Infrastructure > Maintain Extended
ECM Connections. For more information, see “Maintaining Extended ECM
connections” on page 114.

• Subtype: ID of the Case subtype. You find this information in the Content
Server Administration page > Template Workspaces Administration >
Administer Case Types. The subtype ID of a Case is a positive integer
between 31350 and 31399. For more information, see the Content Server
online help for this administration page.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 159
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

22.3.8 Providing access to local folders for the Business


Content window
The Business Content window automatically displays the local Tempo Box folder if
Tempo Box client is installed. In addition, users can add other local folders to the
Local files node in the Business Content window. For this functionality, users must
have the J_6NRL_LFS authorization object. This authorization object is part of the /
OTX/RM_USER role.

To assign the authorization object to a group:

1. Start the PFCG transaction.

2. Find the relevant role and add the J_6NRL_LFS authorization object.

Security settings - When a user accesses a local folder from the Business Content
window, an SAP security alert informs the user about the risk. Users can confirm the
message per access attempt or they can set the security options for their client.

To set the security options on SAP GUI:

1. From the SAP GUI menu, select Options.

2. Select Security > Security Settings.

3. Set Status and Default Action as required.

160 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.3. Customizing the integration into SAP GUI via Generic Object Services

22.3.9 Providing thumbnails for business workspace


documents in the Business Content window
You can display thumbnail pictures for documents that are stored in a business
workspace in the Business Content window. This is a feature of Content Server,
which you must configure accordingly.

Important
Thumbnail pictures for business documents are displayed automatically for
all document formats that are supported by the OpenText Imaging Web
Viewer. For more information, see Section 25.2.3.2 “Using the Business
Documents function” in OpenText Archiving and Document Access for SAP
Solutions - Scenario Guide (ER-CCS).

To provide thumbnails for business workspace documents:

1. On the Content Server Administration page, select Server Configuration >


Configure Presentation > Configure Thumbnails.

2. Enable thumbnail generation and display. Set the MIME types for those file
formats, for which you want to provide thumbnails.
For more information, see the Content Server Administration online help.

22.3.10 Integrating Viewers in the Business Content window


Viewers are used to display documents in Business Content window, DocuLink and
Content Server. The following viewers can be integrated and used to display
documents:

OpenText™ Imaging Web Viewer and OpenText™ Imaging Windows Viewer


Can be used as viewers for files that are stored in Archive Center. They must be
of a MIME type that is supported by Web Viewer.

OpenText™ Content Suite Viewer


Can be enabled in Content Server. It uses an OpenText Brava! Server installation
specifically prepared for this use case. For more information about installation
and configuration, see the respective documentation.

Note: OpenText Brava! View for SAP Solutions runs against the OpenText
Imaging Windows Viewer integration of Archiving and Document Access on
an SAP system.

Since the Business Content window displays documents via Content Server it
cannot call Brava! View for SAP Solutions directly. Instead it uses the viewer
enabled for Content Server.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 161
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

Configuring the Content Server viewer


Configuring Web Viewer and OpenText Imaging Windows Viewer as Content
Server viewer:
• If you want to use one of these viewers define the relevant settings in Content
Server Administration. For more information, see “Configuring Imaging
viewers ” on page 168.
• Configure the mime types. For more information, see Section 8.11 “Customizing
MIME types for preview” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
• Configure the viewer settings in the SAP system. For more information, see
Section 20.2 “Configuration for Java Viewer/Web Viewer/Brava! View” in
OpenText Archiving and Document Access for SAP Solutions - Scenario Guide (ER-
CCS).

Configuring Content Suite Viewer as Content Server viewer:


• Brava! Installation: Brava Server Components for OpenText Content Suite Viewer –
Installation and Administration Guide.
• Content Suite Viewer Administration on Content Server Administration page:
Content Suite Viewer Admin Online Help - Content Server Administration (LLESDV-
H-AGD)

Configuring the Business Content window viewer


The Business Content window displays Content Server content. To use Content
Suite Viewer as viewer within the Business Content window, you enable a menu
entry for the viewer and define that the document opens in the Content Suite Viewer
when the user double-clicks it.

• Enable Content Suite Viewer as Content Server viewer

• Brava! Installation: Brava Server Components for OpenText Content Suite Viewer
– Installation and Administration Guide, available on OpenText My Support
(https://knowledge.opentext.com/knowledge/llisapi.dll/Open/61356446).
• Content Suite Viewer Administration on Content Server Administration page:
Content Suite Viewer Admin Online Help - Content Server Administration
(LLESDV-H-AGD)
• On Content Server, disable that the document opens for editing when the user
double-clicks it.
• Maintain mime types and define that Microsoft Office document are opened with
the viewer. For more information, see “Customizing MIME types for preview”
on page 164.
• Configure the Business Content window so that there is a new menu entry and
the document opens in Content Suite Viewer when the user double-clicks it.

162 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.3. Customizing the integration into SAP GUI via Generic Object Services

To disable editing in Content Server

1. On the Content Server administration page, click Server Configuration >


Configure Security Parameters.

2. In the Document Function section, for the Open function, select Disabled.

Adding Content Suite Viewer action in Business Content window menu:

1. Start the SM30 transaction and enter /OTX/RM_WSC_FCOD in the Table/View


field. Click Maintain.

2. Click New Entries.


3. Customize the new entries according to the following lists.
Add an entry for Business Content window:

• Menu ID: ALPLUS


• Code ID: VIEWDOC
• Description: For example View or Display with Content Suite Viewer
• Activation: Select.
• Function Code: PICK

Add an entry for DocuLink:

• Menu ID: DOCULINK


• Code ID: VIEWDOC
• Description: For example View or Display with Content Suite Viewer
• Activation: Select.
• Function Code: PICK

Note: If you do not want to disable the Open document function on Content
Server, the FETCH function will be used instead of the defined VIEWDOC function
when users double-click a document in Business Content window. You can
circumvent this by defining a description that is alphabetically before the
description of the FETCH action, for example FETCH with description Open and
VIEWDOC with description Display.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 163
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

22.3.11 Customizing MIME types for preview


The Business Content window relies on a hidden Windows Internet Explorer (IE) to
render documents for the preview. Internet Explorer takes care of calling the
respective rendering application. However, some Internet Explorer add-ons, for
example Web Viewer, handle specific MIME types by enabling an in-place rendition.
As a consequence, the Business Content window must use a visible Internet Explorer
to render the corresponding documents.

The /OTX/RM_GOS_DD table keeps a default list of MIME types for which Internet
Explorer add-ons enable an in-place rendition. If this list is not sufficient, you can
maintain a custom list in the /OTX/RM_GOS_DD_C table.

Note: The Business Content window ignores the /OTX/RM_GOS_DD table as


soon as the /OTX/RM_GOS_DD_C table has at least one entry.

Recommended setting for Web Viewer


If Web Viewer is enabled on Content Server, add MIME types of documents to the /
OTX/RM_GOS_DD_C table. If you did not maintain the MIME types in the /OTX/
RM_GOS_DD_C table, it can happen that an archived document that you want to open
in Business Content window causes an infinite loop.

Important
Also add the MIME types from /OTX/RM_GOS_DD if you want to keep the
behavior of these MIME types as well.

Restrictions Web Viewer can only render documents that are archived to an OpenText archive.
For example, if you want to display a Microsoft Word document, Internet Explorer
starts Microsoft Word, but leaves an empty browser window open.

Recommended setting for OpenText Content Suite Viewer


If Content Suite Viewer is enabled on Content Server, add MIME types of
documents to the /OTX/RM_GOS_DD_C table. If you did not maintain the MIME types
in the /OTX/RM_GOS_DD_C table, it can happen that an archived document that you
want to open in Business Content window causes an infinite loop.

Important
Also add the MIME types from /OTX/RM_GOS_DD if you want to keep the
behavior of these MIME types as well.

164 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.3. Customizing the integration into SAP GUI via Generic Object Services

22.3.12 Customizing the GOS Attachment list for Records


Management
If you want to use business attachments and Records Management functionality in
the GOS Attachment list you must activate business functions.

Note: This customizing step is not necessary if you are using Business Content
window. For more information, see “Customizing the Generic Object Services
(SAP GUI) ” on page 152.

With business functions, you integrate the following into the GOS Attachment list:

Button Declare as record

Button View record details

Records Management Status symbol Is record

Business functions
• /OTX/RM_BF_GOS_ATTACHMENT
Integrates Records Management functions into the GOS Attachment list.
• /OTX/RM_DOL_BF_GOS_ATT_LIST
Integrates business attachments into the GOS Attachment list.
• /OTX/RM_BF_DISP_PRINTLIST

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 165
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

Integrates Records Management functionality into the OADR and OADD


transactions.

To activate business functions:

1. In the IMG, navigate to the Extended ECM > Activate Business Functions
activity and click Execute.

2. Open the ENTERPRISE_EXTENSIONS folder and activate the following


options by selecting the checkbox in the Planned Status column:

• /OTX/RM_BF_DISP_PRINTLIST: Records Management for Display


Printlists
• /OTX/RM_BF_GOS_ATTACHMENT: Business Function GOS Attachment

Note: /OTX/RM_DOL_BF_GOS_ATT_LIST is displayed but is no longer


relevant.

3. Click Activate Changes.

22.4 Viewing the old configuration in SAP


After the update, the old configuration is still available in the SAP system, but is no
longer evaluated. You can display the information.

To display the old business object type configuration from the SAP system:

1. Start the SM34 transaction.

2. Open the /OTX/RM_WSC_VCZ view cluster.


The screen shows the new reduced configuration.

3. In the command field, enter &show_legacy_on.

4. Navigate to the configuration that you want to retrieve.


For information about the new business object type configuration, see Section
3.15 “Configuring business object types” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).

166 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.5. Configuring Single Sign-on for Content Server

5. To display the old field mapping for authorization based on category IDs,
navigate to Workspace Authorization > Field Mapping and enter &
show_legacy_on.

22.5 Configuring Single Sign-on for Content Server


When invoking the Content Server HTML dialogs or the Content Server HTML
search page within the SAP GUI, Extended ECM for SAP Solutions uses a single
sign-on (SSO) process to avoid manual authentication. The following prerequisites
apply for this:

• The Content Server server and the OTDS server must be in the same domain or
in a sub-domain of the SAP HTTP server that issues the cookie.
Same domain:
CS = cs.example.com
OTDS = otds.example.com
SAP = sap.example.com
Sub-domain:
CS = cs.paris.example.com
OTDS = otds.paris.example.com
SAP = sap.example.com

Note: This restriction is only valid if you want to use Content Server Classic
View. If you want to use Content Server Smart View or integrations of the
integration widget also cross-domain requests can be handled.
• The user must be a dialog user in SAP, otherwise the SSO ticket cannot be
created.

Restriction If either SSO cannot be achieved in your server and desktop environment or the
when SSO is option Suppress Sending SAP Logon Ticket is turned on in the connection ID
not enabled
configuration (see “Maintaining Extended ECM connections” on page 114), the
Extended ECM for SAP Solutions functionality is restricted as follows:

• The interactive declare dialog will not allow selecting RSI, categories and cross
references. See Section 6.12 “SAP: Assigning a document declaration to a
business object and a document type” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).
• In some cases the user gets a logon screen when accessing Content Server
functionality.
For the caller dialog, the logon screen appears only once, as long as a SAP GUI
session or the SAP Logon application is open. For the Content Server popup
dialog, a logon is always necessary unless an instance of the Web browser has
been open since the latest logon.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 167
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks

Tip: In order to avoid that the user must log in every time a Content Server
dialog pops up under Microsoft Windows, keep an instance of Microsoft
Internet Explorer open.

In order to avoid that the cookie expires and a logon screen is displayed, you can
switch off cookie expiration in the Content Server security settings.

To configure security parameters:

1. Go to the Content Server Administration page and select the Server


Configuration > Configure Security Parameters entry.

2. In the Cookie Authentication Information group, select the Never Expire


option.

22.6 Configuring Imaging viewers


Content Suite provides several means to load and view documents in Content
Server:

• OpenText™ Content Suite Viewer


• OpenText Imaging Web Viewer
• OpenText Imaging Windows Viewer

To configure the Content Suite Viewer:

Note: You must install the Brava Server Components package before enabling
the Content Suite Viewer. For more information, see the Brava Server

168 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
22.6. Configuring Imaging viewers

Components for OpenText Content Server Installation and Administration Guide on


My Support.

This viewer is not enabled by default. Before you can enable this viewer, you
must download and install the Brava Server Components package, which can
be found on My Support.

1. On the Content Server Administration page, click Content Suite Viewer


Administration > Configure Content Suite Viewer Settings.

2. Select the Enable Content Suite Viewer option.

3. In the Viewer Server URL section, type the URL to the Brava Server in the
following format:
http://<computer_name>:<port number>, where <computer_name> is the
name of the computer where the Brava Server Components Package is installed,
and <port number> is the port number specified for the Brava Server
Components.

4. Click Save Changes.

To configure Windows Viewer and Web Viewer:

• On the Content Server Administration page, click Editor Administration and


the configuration options of this section.
For more information about the configuration of the viewers, see the respective
online help pages.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 169
ERLK160200-00-IGD-EN-05
Chapter 23
Preparing a checklist for the customizing team

After you have installed the infrastructure for Extended ECM for SAP Solutions, you
can hand-over the work to those who are responsible for the customizing of the
system as it is described in OpenText Extended ECM for SAP Solutions - Customizing
Guide (ERLK-CGD).

The following tools provide both necessary and useful information:

SAP system
• Diagnostic Program: “Understanding the SAP Diagnostic Program”
on page 135
Tests the customizing and provides solutions for errors.
• Configuration Report: Section 20.1.3 “Understanding the Configuration
Report” in OpenText Extended ECM for SAP Solutions - Customizing Guide
(ERLK-CGD)
Provides information about Extended ECM for SAP Solutions related
customizing in the SAP system.

Content Server
System Report: Section 20.2 “Understanding the Content Server System Report”
in OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD)
Contains the complete configuration information of the Content Server system.
Look for the “Extended ECM Information” section.
After installation, the following sections are interesting: Enterprise Library
Applications, SAP Systems, OpenText Imaging Viewers.
OpenText Administration Client
You can generate a report for OpenText Archive Center: Provides information
for the ArchiveLink setup in SAP (OAC0 transaction).

To generate the system configuration reports:

1. In OpenText Administration Client, log on to the server.


2. OpenText Archive Center

a. Go to Archive Server > System > Reports.


b. In the Reports pane, open the Scenarios tab and select the scenario.
c. In the Actions pane, click Generate Report. A new window opens,
which you can close.
d. Switch to the Reports tab in the Reports pane.
e. Click Refresh to list the newly generated reports.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 171
ERLK160200-00-IGD-EN-05
Chapter 23 Preparing a checklist for the customizing team

f. Double-click one of the generated reports to view it.

OpenText Directory Services Web Client


The System Status page lets you view a System Configuration Report, version
information for the product, and highlights Potential Configuration Issues.

To generate the system configuration reports:

1. From the web administration menu, under the Info heading, click System
Status.

2. On the System Status page, click Download System Configuration Report.

3. The system configuration report downloads to your machine. An


information box displays, depending on your browser settings, that you can
click to display the report.

172 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 24

Transporting Extended ECM for SAP Solutions


Content Server configuration and templates

Exporting and importing a Connected Workspaces configuration together with the


standard functions of Content Server Transport Warehouse, help you moving an
existing configuration from one Content Server installation to another, for example if
you are using development, test and productive systems.

Extensive plausibility checks help you import a working configuration. To reduce


the number of warnings and unresolved dependencies, OpenText recommends that
you use the following order for transport.

Table 24-1: Recommended transport order

Item type Transport method


1 Categories, classifications, and folder Content Server Transport Warehouse
structure, workspace types
2 Unique names Connected Workspaces export and import
3 Variable definitions, Workspace templates Content Server Transport Warehouse
(document templates)
4 Business object types Only for Extended ECM: Connected
Workspaces export and import

24.1 Transporting the Connected Workspaces


configuration
What does the configuration import do?

• The import evaluates Content Server nodes like folders, classifications and
categories as they are used in the configuration of business object type,
workspace type and unique names by the name they had in the source system. If
a node with the same name exists in the target system, it is used, otherwise a
warning is issued. If more than one node with the same path is found, the first
one is used and a warning is issued. You can change the node on the preview
page.
• The import checks the usage of categories with attributes and attribute sets for
location and sub location path in workspace type and external document storage,
RM Classification, classification and multilingual names. If it is not correct a
warning is issued. Additionally, if the category does not contain the used
attributes or attribute sets a warning is issued.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 173
ERLK160200-00-IGD-EN-05
Chapter 24 Transporting Extended ECM for SAP Solutions Content Server configuration
and templates

• When a transport file from the SAP Configuration Report is imported, the
property usages including the property modifier in location, sub location path of
workspace type and multilingual names are substituted by their corresponding
category attribute according to the property mappings in the transport file. If
there is no mapping or if there are multiple mappings, a warning is issued.
• If the transport file contains names for multilingual names in languages that are
not enabled in the target system, a warning is issued. The name is imported, but
it cannot be seen in the workspace type configuration as long as the language is
not enabled. If you change the workspace type before the language has been
enabled, this name is removed from the configuration.
• To find out whether a workspace type in the transport file must be created or
updated, workspace types are searched by their name given in the transport file.
If no business object type can be found, a new type is created. If there is no name
for a workspace type in the transport file, which is the case for an export from an
SAP system, but the workspace type is associated to a business object type in the
target system, this workspace type is used.
• To find out whether a business object type in the transport file must be created or
updated, business object types are searched by their name, and also by the
combination of business object type/business application. If no business object
type can be found that way, a new type is created. If different types are found,
the import is rejected with the message Different Object Types found ….
• If workspace types are used in the Related Items sidebar widget and they are not
exported to the same file, these workspace types are also searched by their
names. You can change the found type on the preview page. This is also done if
only business object types are exported and imported but not their associated
workspace types.

24.1.1 Importing the configuration


To import the Connected Workspaces configuration on Content Server:

1. On the Content Server Administration page, click Connected Workspaces >


Import/Export Configuration.

2. On the following page, click Import Configuration.

3. Select the transport file from your local file system. If you want to use the
transport file that is stored in your personal workspace, you must first
download it.

4. Click Preview. The transport file is checked and you can preview everything
that is going to be imported and where. Errors and warnings are also displayed.

174 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
24.1. Transporting the Connected Workspaces configuration

ID Mapping
Contains all node IDs that have been found in the transport file, for example
for classifications, or for categories that are used for the location or the
workspace name. If the target system contains nodes with the same name as
the source system, they prefilled with that suggestion. You can change the
node.

Workspace Types, Business Object Types, Unique Names, Variable


Definitions
If workspace types, business object types, unique names and variable
definitions are part of the export, they are listed in these sections. You can
see what data is being imported, if workspace types or business object types
are created or updated.

5. Resolve the inconsistencies in the mapping:

a. Click Select to map another node. These settings are buffered and used
when you refresh the preview or start the import. Alternatively, edit the
transport file and save it.
b. Click Preview to read the new changes into the preview.

6. When you are satisfied with the import preview, click Import.
A result page informs you in detail about what has been imported.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 175
ERLK160200-00-IGD-EN-05
Chapter 24 Transporting Extended ECM for SAP Solutions Content Server configuration
and templates

24.2 Transporting categories, classifications and


workspace templates
You can use Content Server Transport to transport categories, classifications and
workspace templates from one Content Server to another Content Server. The
transport of a workspace template contains all subitems and the Related Workspaces
folder with its configuration.

Restrictions
• You can only transport workspace templates. Normal business workspaces
cannot be transported. You will get an error message when you try to add them
to a workbench.
• Group replacement settings are not part of the transport.

Processing sequence
• On the source system:
1. Create a workbench.
2. Add category, classification or workspace template to the workbench.
3. Create a transport package and add workbench items.
4. Download the transport package.
• On the target system:
1. Upload the transport package.
2. Unpack the transport package to a workbench.
3. Deploy the workbench.

The following procedure describes the transport of workspace templates. The


transport of categories and classifications follows the same schema.

Tip: For more information about Content Server Transport, see the Content
Server online help on that topic.

To transport a template:

1. Create a new workbench:

a. From the main menu, select Enterprise > Transport Warehouse.


b. Click Add Item > Workbench.
c. Enter a name and click Add.
2. Add a workspace template to the workbench:

a. From the main menu, select Enterprise > Document templates and find the
workspace template that you want to transport.
b. From the context menu of the workspace template, select Add to
Warehouse.

176 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
24.2. Transporting categories, classifications and workspace templates

c. Select the workbench that you created for workspace templates.

d. Select if you want to include the content of the workspace templates. All
subitems that can be transported will be transported. This also includes the
Related workspaces folder.

3. Create a transport package:

a. In the workbench, click Add all to Transport Package.


To add single items, select Add to Transport Package from the context
menu of that item.

b. Enter the name of the transport package and click Add.

c. Go to the location of the transport package and download it

4. On the target system, import the transport package.

a. From the main menu, select Enterprise > Transport Warehouse.

b. In the Transport Warehouse, click Transport Packages.

c. Click Add Item > Transport Package.

d. Enter a name for the new transport package. Select the ZIP file that you
downloaded from the source system.

e. Click Add.

5. Unpack the transport package.

a. If you do not yet have a workbench for the transport, create it.

b. From the context menu of the transport package, select Unpack.

c. Select the workbench to which you want to unpack the transport package.

d. Click Unpack.

6. Deploy the workbench items.

a. Click a workbench item to view its details.


If there is an Edit button in the Actions column, you can change, for
example, the location where the item will be stored.
You can view the automatically created team roles and edit the team
participants.

b. To deploy a single item, click Deploy in the details view.

c. To deploy the whole workbench, click Deploy workbench.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 177
ERLK160200-00-IGD-EN-05
Glossary
ArchiveLink

An interface between the SAP system and an archiving system. Using


ArchiveLink, mostly static and finished documents are stored. ArchiveLink
documents can be declared in Extended ECM.

attribute

Content Server concept to store metadata. Attributes are organized in categories.


Business properties of a business object are mapped to attributes.

BAdI
See Business Add-In (BAdI).

Business Add-In (BAdI)

SAP method to enhance standard SAP functions with custom functionality.

business attachment

Content Server item, for example a document or a folder, that is added as a link to
the business workspace of a business object. The item, which is used as business
attachment elsewhere, is indicated by an icon and has a link to the respective
business object. The other way around, you can configure a business object type,
so that it can be added to a Content Server item.

Business Content window

Window in SAP ERP that contains content, which is related to the business object.
The Business Content window can be opened in an SAP ERP system from the
Generic object services (GOS) menu of a business object. The Business Content
window displays the business workspace and its content, business attachments,
business documents (ArchiveLink), notes and local files.

business object

Representation of a “real life” object in the business application. This can be, for
example, a business partner, a service process, or a product. Business objects are
the center point of Extended ECM.

business reference

Business object that is linked to a business workspace. If the business workspace


already exists, users add the business object as business reference to it.

business object type

Configuration item for business objects in Content Server. The business object
type describes the structure of the data. A business object type in Content Server
has its counterpart in the business application.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 179
ERLK160200-00-IGD-EN-05
Glossary

business workspace

Content Server item that contains documents and other items which are related to
a business object.

cases and binders


See business workspace.

category

Content Server concept to store metadata. A category contains attributes or


attribute sets. A category can be mapped to store metadata delivered from the
business application.

classic UI

Content Server user interface with folders, function menus and sidebars. As
opposed to Content Server Smart View.
See Also Smart View.

classification

Classifications are used to categorize Content Server items, for example,


documents, compound documents, and folders into a taxonomy of Classifications
called Classification Trees. For business workspaces, classifications control what
kind of business workspace can be created in a certain folder.

Connected Workspaces

Content Server module that enables the use of business workspace with or
without a connection to a business application.

declaration
See document declaration.

document declaration

Definition of how a document is to be stored in Archive Center via ArchiveLink.

document metadata

Describes the document and its business context. Different types of documents
may have different metadata assigned. Metadata can be used to search for a
document.

document properties

Set of attributes that all documents share; for example, the owner of a document
or the creation date.

document templates
See workspace templates.

180 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Glossary

Generic Object Services (GOS)

SAP: Functions that are not application-specific and can generally be used for any
business object, e.g. creating or displaying the business workspace.

GOS
See Generic Object Services (GOS).

group replacement

Method to dynamically assign access rights for a Content Server item such as a
business workspace or a document to a group of users. The group replacement is
typically based on attributes of the Content Server item.

impersonation

Method in which users of the business application utilize other users to gain
access to Content Server. Impersonation must be implemented according to the
requirements of the business application.

indexing

Process of collecting data about Content Server items so that they can be searched
with Content Server search functionality.

integration widget

Enables an integration method to display Content Server content in HTML-based


application. Content is displayed with JavaScript and HTML5 technology rather
than embedding the classical Content Server user interface.

OpenText Directory Services (OTDS)

A repository of user information and a collection of services to manage this user


information. OTDS is used by Content Server for user authentication.

OpenText Records Management

Content Server module that controls documents and other objects based on rules
and classifications. Compliance and other legal regulations require that
documents have a controlled life time cycle that they are archived, that they can
be frozen or that they are deleted after a certain time. Records Management also
controls access to the documents. To set a document under the regulations of
Records Management, it is declared as record.

OSS notes
See SAP Notes.

OTDS
See OpenText Directory Services (OTDS).

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 181
ERLK160200-00-IGD-EN-05
Glossary

perspective

Controls how users see the layout of a business workspace in Content Server
Smart View. Perspectives consider rules, for example, the workspace type,
template, or the user group. You design and configure a perspective in
Perspective Manager, a tool that walks you through the creation of a perspective
and translates it into ActiveView coding.

Perspective Manager
See perspective.

policies

Method to transfer and apply SAP authorization objects in Content Server.

print lists

Documents that are created by the SAP system and, if necessary, can be processed
automatically. They represent extracts from the SAP data base, compiled
according to specific criteria, and created by reports.

property provider

Program or web service that delivers properties of a business object from the
business application to Content Server.

record
See OpenText Records Management.

Records Management
See OpenText Records Management.

relationship

Hierarchical relationship between business objects that are visualized as


relationships between business workspaces. A sidebar widget and Related
Workspaces Folders make related business workspaces visible. Automatic
relationships are defined in the property provider. Users can establish manual
relationships.

RFC service

A program used for communication between the SAP application and the archive
system via RFC (Remote Function Calls).

SAP Notes

Notes provided by SAP that contain post-release changes or corrections for


already released versions of SAP products. When you encounter SAP-specific
problems or false behavior in SAP programs, especially after or during a new
installation of product components, check the SAP Support Portal for necessary
SAP notes.

182 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Glossary

SAP Reference IMG (SPRO)

A tool for customizing in the SAP system, opened with the SPRO transaction.

SAP Business Add-In


See Business Add-In (BAdI).

sidebar widget

Element of a business workspace in Classic View that displays various types of


business workspace metadata and information to the end user.

simple search

Saved query and customized search form that can be used to find business
workspaces, cases and binders, and to create shortcuts. Also known as Custom
View Search in Content Server.

Smart View

Content Server user interface with a landing page and container pages. The
content is presented in tiles that contain widgets. The pages are highly
configurable using the Perspective Manager.
See Also classic UI.

SPRO
See SAP Reference IMG (SPRO).

system attributes

Metadata that all content items have in common, for example item names, creator
of an item, or the modification date.

widget

Element of the user interface that displays information for the user.

workspace templates

Basis for new business workspaces that are managed with Extended ECM for
SAP Solutions. Templates are offered to the user based on the classification and
the storage location of the new document.

workspace type

Content Server object that controls the location where a business workspace is
stored, some of the GUI components such as sidebar widgets, and the name
pattern of the business workspace.

OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 183
ERLK160200-00-IGD-EN-05

You might also like