Opentext™ Extended Ecm For Sap Solutions: Installation and Upgrade Guide
Opentext™ Extended Ecm For Sap Solutions: Installation and Upgrade Guide
Opentext™ Extended Ecm For Sap Solutions: Installation and Upgrade Guide
Solutions
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.
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
Disclaimer
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
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
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide iii
ERLK160200-00-IGD-EN-05
Table of Contents
iv OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Table of Contents
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide v
ERLK160200-00-IGD-EN-05
Table of Contents
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
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.
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 – 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 - User Management and Access Control
Scenarios (ERLK-CUM)
This guide discusses user management and access control scenarios.
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.
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
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:
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:
14 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
2.2. SAP system requirements
Patch levels
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
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).
Important
See the Release Notes for a comprehensive and most current list of
prerequisites.
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.
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).
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.
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.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 17
ERLK160200-00-IGD-EN-05
Chapter 2 Prerequisites
Note: You only need these passwords and packages if they are not already
installed 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
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.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 21
ERLK160200-00-IGD-EN-05
Chapter 3 Installing Extended ECM for SAP Solutions
22 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 4
Installing the SAP package
• 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.
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.
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.
After the installation, you must activate a Business Configuration Set (BC set) for
every client.
• /OTEXRL/RM_SEA
24 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 5
Generating roles
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.
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
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).
• 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.
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
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
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.
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
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.
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
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.
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.
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.
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.
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.
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
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.
6. Only Unix systems: After deploying the services, change the directory of the
log files.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 35
ERLK160200-00-IGD-EN-05
Chapter 9 Deploying Extended ECM Web Services
36 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
9.2. Deploying Content Web Services
You must now deploy the web service cws to the Tomcat installation on the server
where you also installed Archive Center:
2. Only Unix systems: After deploying the services, change the directory of the
log files.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 37
ERLK160200-00-IGD-EN-05
Chapter 9 Deploying Extended ECM Web Services
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>
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
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
For the different combinations, there may be limitations. For information about all
known issues, see the Release Notes.
42 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
10.1. Supported combinations
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.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 45
ERLK160200-00-IGD-EN-05
Chapter 12
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
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
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
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
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
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
Table 12-2: Upgrade checklist for upgrade from Extended ECM for SAP
Solutions 16 to 16.2 (SAP system first)
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
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
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
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
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
58 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
12.2. Upgrading the database schema
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.
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
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
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
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
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
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
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
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
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)
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
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
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
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
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
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
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.
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.
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.
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”
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
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.
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.
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
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
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:
/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
/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
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.
In addition to the SAP server certificate, you must export a certificate for the portal.
• 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
5. Click Save.
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.
1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Activate HTTP Service activity 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.
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
1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create HTTP Connections activity and click Execute.
2. Click Create.
• 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.
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.
7. Check that the value in the Status HTTP Response field is 200 which indicates
that the request was successful.
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
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
• 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.
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.
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
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
• 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
• 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.
• Enterprise Library
• Extended ECM
• OpenText Directory Services
• Enterprise Library Content Services
• Content Server Member Services
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
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.
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.
8. Open the Consumer Security tab and select SAP Authentication Assertion
Ticket.
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:
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.
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
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
• Enterprise Library
• Extended ECM
• OpenText Directory Services
• Enterprise Library Content Services
• Content Server Member Services
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity and click Execute.
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).
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
Click Next.
9. In the SOAP Protocol step, set the Message ID Protocol option to Suppress ID
Transfer
Click Next.
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:
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
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
• Enterprise Library
• Extended ECM
• OpenText Directory Services
• Enterprise Library Content Services
• Content Server Member Services
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity and click Execute.
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
Click Next.
9. In the SOAP Protocol step, set the Message ID Protocol option to Suppress ID
Transfer
Click Next.
11. Repeat Step 4 to Step 10 to create a logical ports according the following table:
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
112 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.4. Configuring the Service Provider Interface service
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure structure and open it.
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.
• 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
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:
114 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
18.5. Maintaining Extended ECM connections
Connection ID
Enter a connection ID.
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
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).
• 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
• 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
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.
Example:
4. Click Save.
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.
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:
Prerequisite
• You have configured the web servers for HTTPS.
• You have exported the certificate from Content Server in the Base64 format.
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.
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
The following procedure describes how to import a certificate to the Extended ECM
keystore ecmlink-spi.cacerts.
To import a certificate:
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
<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
1. On the global menu, click Enterprise > Extended ECM, and then click
Connections to Business Applications (External Systems).
3. Specify the parameters for your business application according to the list below.
4. Click Add.
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.
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
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.
124 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.3. Configuring the storage provider
3. In the Archive Server field, enter the name of the Archive Center host.
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"].
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
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.
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.
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.
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
• 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.
128 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
19.5. Preparing document declaration
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.
• 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
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.
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
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.
You can also create system categories manually, but copying the imported item
types ensures that no mandatory category attributes are missing.
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.
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).
Frame Embedding
Must be unchecked. You do not want to prevent request handlers from
being embedded in external frames.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 133
ERLK160200-00-IGD-EN-05
Chapter 20
Verifying the installation
Important
You can run the infrastructure diagnostic program after specifying at least
the Extended ECM connection in the Infrastructure section of the IMG.
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.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 135
ERLK160200-00-IGD-EN-05
Chapter 20 Verifying the installation
136 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
20.1. Analyzing the SAP system
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 137
ERLK160200-00-IGD-EN-05
Chapter 20 Verifying the installation
138 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
20.1. Analyzing the SAP system
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 139
ERLK160200-00-IGD-EN-05
Chapter 20 Verifying the installation
140 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
20.1. Analyzing the SAP system
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
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.
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
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).
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 147
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks
• Workspace section
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
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.
New: You can now display a custom logo Content Server 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.
• header_extended_ecm.svg
• header_extended_ecm_inv.svg
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.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 151
ERLK160200-00-IGD-EN-05
Chapter 22 Performing additional optional tasks
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).
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
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.
Service Type
Select Single Service .
Icon
ICON_BUSINAV_DATAMODEL
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.
New: You can now customize, which items are displayed in the Business
Content window of a certain business object type.
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
• 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.
1. In the IMG, navigate to the Extended ECM > Business Content Window >
Maintain Business Content Window Menu and click Execute.
Code ID
Enter the code ID. Use the F4 help to retrieve the code ID.
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
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
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).
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.
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
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.
Tip: For more customizing options for the Business Content window, see
“Select items to be displayed in Business Content window ” on page 154
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).
2. On the left, expand the Content Server website, and click the Content Server
Application.
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
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.
1. Copy all entries from the /OTX/RM_STWL table to the Subtype column of the /
OTX/RM_STWL_C table.
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.
• 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
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.
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
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).
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.
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
• 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
2. In the Document Function section, for the Open function, select Disabled.
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
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.
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.
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
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:
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
1. In the IMG, navigate to the Extended ECM > Activate Business Functions
activity and click Execute.
To display the old business object type configuration from the SAP system:
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.
• 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.
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
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.
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.
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).
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).
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
1. From the web administration menu, under the Info heading, click System
Status.
172 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Chapter 24
• 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.
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.
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
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.
Tip: For more information about Content Server Transport, see the Content
Server online help on that topic.
To transport a template:
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
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.
d. Enter a name for the new transport package. Select the ZIP file that you
downloaded from the source system.
e. Click Add.
a. If you do not yet have a workbench for the transport, create it.
c. Select the workbench to which you want to unpack the transport package.
d. Click Unpack.
OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide 177
ERLK160200-00-IGD-EN-05
Glossary
ArchiveLink
attribute
BAdI
See Business Add-In (BAdI).
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.
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
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.
category
classic UI
Content Server user interface with folders, function menus and sidebars. As
opposed to Content Server Smart View.
See Also Smart View.
classification
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
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
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
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
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
RFC service
A program used for communication between the SAP application and the archive
system via RFC (Remote Function Calls).
SAP Notes
182 OpenText Extended ECM for SAP Solutions – Installation and Upgrade Guide
ERLK160200-00-IGD-EN-05
Glossary
A tool for customizing in the SAP system, opened with the SPRO transaction.
sidebar widget
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