CUSTOMER
Installation Guide
SAP ECTR for SAP S/4HANA 1.1
DOKUMENTHISTORIE
Achtung
Stellen Sie vor Beginn der Implementierung sicher, dass Ihnen die aktuelle Version dieses Dokuments vorliegt.
Dieser Guide ist gültig für SAP ECTR for SAP S/4HANA S/4HANA 1.1.5.1 Sie finden die Version auf dem SAP Help Portal unter
https://help.sap.com/viewer/p/SAP_ENGINEERING_CONTROL_CENTER
Version Datum Änderung
1.0 2019-05-29 Neuerstellung
2.0 2019-07-26 Neues Kapitel "CLFM0002 Aufruf vor dem Buchen
der Klassifizierungsdaten (Optional)" hinzugefügt
3.0 2019-11-21 Kapitel "Systemvoraussetzungen" optimiert
4.0 2020-07-02 Kapitel “Abschließende Aktionen” optimiert
Kapitel “Systemvoraussetzungen” optimiert
5.0 2021-04-29 Kapitel "Systemvoraussetzungen" optimiert
6.0 2021-10-21 Kapitel "Systemvoraussetzungen" optimiert
TABLE OF CONTENTS
1 EINFÜHRUNG ... 4
1.1 ÜBER DIESES DOKUMENT ... 4
1.2 VOR DEM START ... 4
1.2.1 SAP-HINWEISE FÜR DIE INSTALLATION ... 4
1.2.2 INFORMATIONEN AUF DEM SAP-SERVICE-MARKETPLACE ... 4
1.2.3 NAMENSKONVENTIONEN ... 5
2 VORBEREITUNG ... 6
2.1 SYSTEMVORAUSSETZUNGEN ... 6
2.1.1 FRONTEND ... 6
2.1.1.1 Hardware ... 6
2.1.1.2 Software ... 6
2.1.2 BACKEND ... 6
2.2 BENUTZER FÜR INSTALLATION UND KONFIGURATION ... 6
2.2.1 BETRIEBSSYSTEM ... 6
2.2.2 SAP-SYSTEM ... 7
2.3 EINRICHTUNG DES SAP-SYSTEMS ... 9
2.3.1 KPRO ... 9
2.3.2 SAP INSTALLATION SERVER ... 9
3 INSTALLATION ... 10
3.1 SAP FRONT-END INSTALLER ... 10
3.2 INSTALLATIONSUMGEBUNG ... 10
3.3 ERWEITERUNGEN (USER-EXITS) KONFIGURIEREN ... 12
3.3.1 CLFM0002 AUFRUF VOR DEM BUCHEN DER KLASSIFIZIERUNGSDATEN (OPTIONAL) ... 12
3.4 ABSCHLIEßENDE AKTIONEN ... 13
4 UPDATE DER KONFIGURATIONSSPEZIFISCHEN DATEIEN ... 14
4.1 UPDATE DES JAVA-CONNECTORS ... 14
1 EINFÜHRUNG
Sie können das SAP ECTR for SAP S/4HANA schnell und einfach installieren. Erstellen Sie zunächst für Entwicklungszwecke eine Standardinstallation auf einem SAP-System. Dort können Sie kundenspezifische Anpassungen testen. Die Gefahr von Fehlern bei der endgültigen Installation wird minimiert.
1.1 Über dieses Dokument
Einsatzmöglichkeiten
Der Installationsleitfaden gibt Systemadministratoren alle wichtigen Informationen zur Installation und Postinstallation von SAP ECTR for SAP S/4HANA.
Integration
Ein lauffähiges SAP-System ist die Voraussetzung für die Installation von SAP ECTR for SAP S/4HANA.
1.2 Vor dem Start
1.2.1 SAP-Hinweise für die Installation
Sie müssen die folgenden SAP-Hinweise lesen und ins SAP-System einspielen, bevor Sie mit der Installation beginnen. Diese SAP-Hinweise enthalten die aktuellsten Informationen zur Installation sowie Korrekturen für die Installationsdokumentation.
Die aktuellsten Versionen der SAP-Hinweise finden Sie unter:
https://support.sap.com/en/my-support/knowledge-base.html
SAP-Hinweisnummer Titel
2325172 Releasestrategie für das ABAP-Add-on ECTR
1.2.2 Informationen auf dem SAP-Service-Marketplace
Dokumentation
Titel Internetadresse
Master Guide Configuration Guide Operations Guide Application Help
https://help.sap.com/viewer/p/SAP_ENGINEERING_CONTROL_CENTER
SAP PLM https://www.sap.com/products/supply-chain-iot/plm-r-d-engineering.html
Allgemeine Links
Titel Internetadresse
SAP-Hinweise https://support.sap.com/en/my-support/knowledge-base.html
Installation Guide https://help.sap.com/viewer/p/SAP_ENGINEERING_CONTROL_CENTER Security Guide https://www.sap.com/corporate/en/company/security.html
SAP Help Portal http://help.sap.com
OSS-Meldungen Anlegen auf Komponente PLM-ECC
What's new in SAP ECTR 5.2 and SAP ECTR for SAP S4HANA 1.1
https://wiki.scn.sap.com/wiki/x/rwgeGg
Der Link ist auch im Hilfe-Menü in SAP ECTR for SAP S/4HANA verfügbar
1.2.3 Namenskonventionen
In dieser Dokumentation werden die folgenden Namenskonventionen verwendet:
Variablen
Fügen Sie Einträge für Ihre Komponente nach Bedarf hinzu oder entfernen Sie Einträge.
Variable Beschreibung
<SAPSID> SAP-System-ID in Großbuchstaben
<sapsid> SAP-System-ID in Kleinbuchstaben
<DBSID> Datenbanksystem in Großbuchstaben
<dbsid> Datenbanksystem in Kleinbuchstaben
<INSTDIR> Installationsverzeichnis für das SAP-System
<MEDIA-DIR> Medienverzeichnis
<OS> Betriebssystem
2 VORBEREITUNG
2.1 Systemvoraussetzungen 2.1.1 Frontend
2.1.1.1 Hardware
Hier finden Sie die Grundvoraussetzungen zur Installation von SAP ECTR for SAP S/4HANA auf einem PC.
Wenn Ihr Gerät diese Anforderungen nicht erfüllt, lässt sich SAP ECTR for SAP S/4HANA möglicherweise nur eingeschränkt nutzen.
Prozessor: 2,0 GHZ oder schneller
RAM: 8 GB (Gigabyte) oder mehr
Festplattenspeicher: 300 GB freier Speicher oder mehr
Hinweis
Die Hardwarevoraussetzungen gelten ausschließlich für das Arbeiten mit SAP ECTR for SAP S/4HANA. Wenn Sie eine Integration nutzen, beachten Sie zusätzlich die Systemvoraussetzungen des jeweiligen Herstellers des integrierten Systems.
2.1.1.2 Software
Windows 10 (64 Bit)
.NET Framework 4.6.2
Visual C++ 2013 and Visual C++ Redistributable Package
SAP GUI, ab Version 760
Für eine erfolgreiche Integration des SAP 3D Visual Enterprise Viewer müssen folgende Voraussetzungen erfüllt sein:
SAP 3D Visual Enterprise Viewer ab Version 9.0.600
Beachten Sie, dass für eine erfolgreiche Installation des Add-Ons für den SAP 3D Visual Enterprise Viewer der Viewer vor SAP ECTR for SAP S/4HANA installiert werden muss. Sonst wird im SAP- Frontend Installer die nötige Option zur Installation des Add-Ons nicht angezeigt.
Microsoft Office
2013
2016
2019
2.1.2 Backend
Ab SAP ECC 6.0 mit dem im Hinweis 2049249 zu SAP ECTR for SAP S/4HANA 520 beschriebenen Komponentenstand.
SAP-Dokumentenverwaltung und SAP Content Server
2.2 Benutzer für Installation und Konfiguration
Für eine erfolgreiche Installation sind folgende Benutzer notwendig:
2.2.1 Betriebssystem
Ein Benutzer mit Administrationsrechten oder über SAP-Installer
2.2.2 SAP-System
Ein Benutzer mit Berechtigung für die folgenden Berechtigungsobjekte
Berechtigung Beschreibung
S_C_FUNCT
S_GUI Berechtigung für SAP GUI-Aktivitäten
S_PROGRAM
S_RFC
S_TCODE Berechtigung für die Transaktion CDESK
S_USER_GRP
S_WF_WI
C_AENR_BGR CC-Änderungsstamm - Berechtigungsgruppe
C_AENR_ERW CC-Änderungsdienst Erweiterte
Berechtigungsprüfung
C_KLAH_BKP Berechtigung Klassenpflege
C_DRAD_OBJ Objektverknüpfungen
Anlegen/Ändern/Anzeigen/Löschen
C_DRAW_BGR Berechtigung für Berechtigungsgruppen
C_DRAW_DOK Berechtigung für Dokumentzugriff
C_DRAW_STA Berechtigung Dokumentstatus
C_DRAW_TCD Berechtigung Aktivitäten zu Dokumenten
C_DRAW_TCS Statusabhängige Berechtigungen für Dokumente C_DRZA_TCD
C_DRZI_TCD
C_STUE_BER CS-Stücklistenberechtigungen
Hinweis Beschreibung
555812 - CDESK CAD desktop: Required authorization
Verwenden Sie die Vorlagenrolle /DSCSAG/ECTR_BASE.
Ein Benutzer mit Entwicklungsschlüssel (für BAdIs) und der Berechtigung für diese Transaktionen (zusätzlich zu den o.g. Berechtigungsobjekten)
Berechtigung Beschreibung
SE03 Transport Utilities
SE09 Aufträge verwalten
SE11 SAP DDIC anzeigen
SE16n Tabelleninhalt anzeigen
SE18 BAdI Definition
SE19 BAdI Implementierung
SE30 Performance Analyse
SE37 Funktionsbausteine ausführen
SE38 Reports ausführen
SE80 ABAP Workbench starten
SE91 Meldungen anzeigen
SE93 Transaktionen anzeigen
SPRO Customizing
SU01 User anzeigen
OAC0 - KPRO Content repositories pflegen
OACT - KPRO Ablagekategorien pflegen
CSADMIN KPro überwachen
ST22 Laufzeitfehler anzeigen
STMS Transportübersicht
SLG1 Anwendungslog
SM12 Sperrübersicht
SM21 Systemlog
Berechtigung Beschreibung
SM59 Konfiguration RFC-Verbindung (Trace anschalten)
ST01 Systemtrace
ST05 SQL-Trace
2.3 Einrichtung des SAP-Systems
2.3.1 KPro
SAP ECTR for SAP S/4HANA benötigt den Knowledge Provider (KPro). KPro ist ein eigenständiges
Werkzeug zur Ablage von Originalen. KPro nutzt spezielle BAPIs für das Ablegen / Entnehmen (Einchecken / Auschecken) von Dokumenten, zur Verknüpfung von Originalen und für das Caching.
Nehmen Sie folgende Voreinstellungen vor und kontrollieren Sie die Voraussetzungen:
Legen Sie alle Dokumentarten in KPro ab, nicht nur die CAD-Dokumente.
Wenn Sie eine Arbeitsstation neu einrichten, installieren Sie zuerst einen SAP GUI (neueste Version).
Stellen Sie sicher, dass Sie einen Zugriff und die erforderlichen Rechte auf einem SAP-System haben.
Das SAP-System ist mit einem laufenden KPro-Server verbunden. Überprüfen Sie die Verbindung mit der Transaktion CV01N.
Sie haben sich die KPro-Ablagekategorie für den Installationsvorgang notiert.
Sie können diese Informationen in der Datei default.txt nachlesen.
2.3.2 SAP Installation Server
Wenn Sie eine zentrale Installation haben, benötigen Sie einen SAP Installation Server. Wenn Sie eine Installation auf eine beliebige Anzahl von Client Maschinen verteilen, ist die Installation zentral.
Weiterführende Informationen finden Sie auf dem SAP Service Marketplace unter:
https://help.sap.com/
3 INSTALLATION
3.1 SAP Front-End Installer
Sie können SAP ECTR for SAP S/4HANA über einen SAP Frontend Installer in Ihrer Systemlandschaft installieren.
Führen Sie den SAP ECTR Installer mit Administratorrechten aus.
Wählen Sie im folgenden Dialog die zu installierenden Komponenten aus.
Folgen Sie den Anweisungen im SAP Frontend Installer.
Hinweis
Bei der Angabe des Installationspfades sind nur die folgenden Zeichen erlaubt:
[A-Z], [a-z], [0-9], [+;-;_], Leerzeichen werden durch einen Unterstrich ersetzt
3.2 Installationsumgebung
Die folgenden Abschnitte erläutern die Verzeichnisstruktur der Installationsumgebung:
Installation von Dateien
Einstellungen in den Dateien
Anpassung der Installation an kundenspezifische Bedürfnisse
Die Schreibweise für den nachfolgenden Verzeichnisbaum folgt der Windows-Notation, gilt aber analog für die Unix-Umgebungen.
Verzeichnisstruktur Beschreibung
%PLM_INSTDIR%
%PLM_INSTDIR% ist das Installationsverzeichnis. In der Windows Umgebung ist dies normalerweise C:\Program Files (x86)\SAP\ECTR
_ addons\
Dieses Verzeichnis enthält zusätzlich bereitgestellte Funktionen, die den Umfang von SAP ECTR for SAP S/4HANA erweitern. Dies kann zum Beispiel ein eingebundener Viewer sein.
_ basis\
Enthält diverse Ordner mit den Systemkomponenten für die Basisinstallation. Die Inhalte dieser Ordner werden ggf. bei Updates überschrieben. Für die kundenspezifische Anpassung existiert eine gesonderte Ordnerstruktur.
_ aux-files\...
In diesem Verzeichnis befinden sich die
Standardsymbol Definitionen sowie weitere Dateien, die für die Ausführung notwendig sind.
_ classes\
In diesem Verzeichnis befinden sich die jar-Archive, die für die Ausführung notwendig sind.
_ config\
In diesem Verzeichnis finden Sie die Preference- Dateien, die an die jeweilige Umgebung angepasst werden müssen. Preference-Dateien sind
Textdateien mit der Definition von
Umgebungsvariablen, die das Verhalten der SAP-
Verzeichnisstruktur Beschreibung
_ dictionary\
_ de _ en
In diesem Verzeichnis befindet sich die Standard Dictionary Datei. Die Datei kann in mehreren Sprachen vorliegen.
sys\win\
Enthält diverse Ordner mit Systemkomponenten.
bin\...
In diesem Verzeichnis befinden sich diverse Startdateien, die zur Ausführung benötigt werden.
icons
In diesem Verzeichnis befinden sich verschiedene Symbole. SAP ECTR for SAP S/4HANA arbeitet mit verschiedenen Applikationen zusammen. Ein Symbol kann einer Applikation zugewiesen werden und sie repräsentieren.
jre64\...
In diesem Verzeichnis befindet sich die Java- Laufzeitumgebung, das für die Ausführung benötigt wird. SAP ECTR for SAP S/4HANA verwendet die Version 1.8.0.
lib64 In diesem Verzeichnis befinden sich .dll-Dateien, die für die Ausführung notwendig sind.
_ customize\
In diesem Verzeichnis befinden sich Ordner mit Einstellungsdateien, mit denen weitreichende kundenspezifische Anpassungen für das Verhalten von SAP ECTR for SAP S/4HANA vorgenommen werden können. Sie finden vorhandene Lizenzen und Hilfsprogramme an dieser Stelle. Der Inhalt dieser Verzeichnisse wird bei einem Update nicht überschrieben.
_ aux-files
In diesem Verzeichnis befinden sich kundenspezifische api-Definitionen.
_ classes\...
Hier werden die kundenspezifischen Klassen gespeichert. In diesen Klassen kann SAP ECTR for SAP S/4HANA auf die Bedürfnisse des jeweiligen Kunden angepasst werden.
Verzeichnisstruktur Beschreibung
_ exec\win\
_ addutils
Verzeichnis für kundenspezifische Programmdateien.
_ license
In diesem Verzeichnis befindet sich die Lizenzdatei mit dem Namen activation.txt.
_ scripts\... Verzeichnis für kundenspezifische Script-Dateien.
_ documentation
_ de\...
_ en\...
In diesem Verzeichnis befinden sich Dokumentationen wie die Application Help.
_ templates In diesem Verzeichnis befinden sich die Vorlagendateien für die unterschiedlichen Dokumentarten.
3.3 Erweiterungen (User-Exits) konfigurieren
3.3.1 CLFM0002 Aufruf vor dem Buchen der Klassifizierungsdaten (Optional)
Um die Veränderung an einer Klasse automatisch in SAP ECTR for SAP S/4HANA angezeigt zu bekommen (Observer) muss die Erweiterung CLFM0002 implementiert werden.
Hinweis
Wenn diese Erweiterung nicht implementiert wird, werden Klassen unter Umständen mit veralteten Metadaten dargestellt.
Prüfen Sie, ob die Erweiterung schon im SAP-System vorhanden ist. Zeigen Sie dazu den Funktionsbaustein EXIT_SAPLCLFM_002 mit der Transaktion SE37 an.
Machen Sie einen Doppelklick auf "ZXCLFU02".
Wenn die Meldung "Include ZXCLFU02 does not exist" angezeigt wird, ist die Erweiterung noch nicht implementiert und muss angelegt werden.
Implementieren Sie die Erweiterung. Legen Sie dazu mit der Transaktion CMOD ein neues Projekt an, z.B.
"Z_ECTR".
Weisen Sie die Erweiterung CLFM0002 über Zuordnung Erweiterung zu.
Aktivieren Sie die Komponenten.
Machen Sie einen Doppelklick auf einen Exit EXIT_SAPLCLFM_002 und legen Sie das Include an.
Fügen Sie den Quellcode in das Include ZXCLFU02 ein.
*********************************************************************
* for PLM / SAP Engineering Control Center
*********************************************************************
CALL METHOD /dscsag/utils=>exit_saplclfm_002 EXPORTING
i_called = i_called t_allkssk = t_allkssk[]
t_delcl = t_delcl[]
t_delob = t_delob[].
3.4 Abschließende Aktionen
Um ein fehlerfreies Verhalten von SAP ECTR for SAP S/4HANA zu gewährleisten, führen Sie folgende Funktion im Administratormenü durch:
Klicken Sie in der Menüleiste auf Administration.
Öffnen Sie das Flyout SAP Engineering Control Center System Setup.
Führen Sie nacheinander folgende Funktionen aus. Weitere Informationen finden Sie in der Application Help.
SAP ECTR for SAP S/4HANA-Einstellungen ins SAP-System übertragen
Einstellen der ABAP-Schalter
Auswahl von Objektdaten für SAP ECTR for SAP S/4HANA Report /DSCSAG/OBSERVER_CLEAR einplanen
4 UPDATE DER KONFIGURATIONSSPEZIFISCHEN DATEIEN
Jedes neue SAP ECTR for SAP S/4HANA-Update bringt Neuerungen in den konfigurationsspezifischen Dateien, z.B. default.txt, mit sich. Die Neuerungen befinden sich im Verzeichnis
%PLM_INSTDIR%\template-customize\. Für den einfachen Vergleich der Dateien empfehlen wir Ihnen ein Werkzeug zum Vergleich von Textdateien. Sie sehen auf einen Blick, welche neuen Variablen
hinzugekommen sind und können die Variablen bei Bedarf direkt in ihr produktives Verzeichnis kopieren.
4.1 Update des Java-Connectors
Um die neueste Version des Java-Connectors einzuspielen, tauschen Sie folgende Dateien aus:
%PLM_INSTDIR%\basis\sys\win\lib64\sapjco3.pdb
%PLM_INSTDIR%\basis\sys\win\lib64\sapjco3.dll
%PLM_INSTDIR%\basis\libraries\sapjco3.jar
www.sap.com/contactsap
