Erstinstallation / Import des PPP
Auf dieser Seite
Problem
Wie Sie das sophisTex PPM Process Package (PPP) in einer SAP-Umgebung installieren und bereitstellen – mit den Optionen Transportimport (Frontend und Backend getrennt oder Embedded), Add-on-Installation mit SAINT und Deployment auf SAP BTP.
Umgebung
Installations- und Importverfahren des PPP
Lösung
Option 1: Import per Transport
-
Melden Sie sich am Zielsystem an, in das Sie importieren möchten:
- Bei getrenntem Frontend- und Backend-System müssen diese Schritte in beiden Systemen mit der jeweiligen Datei durchgeführt werden. Die Transportdateien des PPP sind immer in einen Frontend- und einen Backend-Transport aufgeteilt
- Bei einem Co-Deployed-System (Embedded) müssen sowohl der Frontend- als auch der Backend-Transport in dasselbe System importiert werden
- Weitere Hinweise finden Sie unter Import von Releases: Best Practices
-
Starten Sie die Transaktion STMS
-
Klicken Sie im Einstiegsbild von STMS auf Overview → Imports (oder drücken Sie F5 bzw. klicken Sie auf das Lkw-Symbol „Imports“)
-
Doppelklicken Sie auf das System, dessen Importqueue Sie verwenden möchten → Sie sehen jetzt die Importqueue (Liste der wartenden Transporte)
-
Ist der Transport nicht bereits automatisch vorhanden:
-
Wählen Sie im Menü Extras → Other requests → Add (oder Request → Add request to import buffer)
-
Im Pop-up „Add transport request to import queue“:
- Geben Sie die Transportnummer ein
- Optional: Geben Sie bei Bedarf den Zielmandanten ein
- Bestätigen Sie mit Enter/OK. → Der Transport erscheint jetzt in der Queue (bei Bedarf mit F5 aktualisieren)
-
-
Markieren Sie den Transport in der Liste (anklicken)
-
Klicken Sie auf Import
-
Im Importdialog:
- Wählen Sie die Optionen (z. B. „Background“ für einen Import ohne Beaufsichtigung, „Synchronous“ für einen sofortigen Import)
- Setzen Sie bei Bedarf unbedingte Modi
- Starten Sie den Import (OK).
-
Warten Sie, bis der Import abgeschlossen ist
-
War dies die erste Installation des PPP, führen Sie die Nacharbeiten nach der Installation durch
-
Führen Sie die Nacharbeiten nach dem Update durch
Alternative Option 2: Installation mit SAINT
-
Melden Sie sich im Mandanten 000 an (sehr wichtig für SAINT)
-
Starten Sie die Transaktion SAINT
-
Installationspaket laden
- Klicken Sie auf die Drucktaste oder den Menüeintrag Installation Package → From Application Server (empfohlen, wenn das Basis-Team das AAK-Paket in das Transportverzeichnis des Servers hochgeladen hat) ODER From Frontend (wenn Sie die .SAR- oder Paketdatei lokal auf Ihrem PC haben – bei großen Paketen seltener)
- Suchen und wählen Sie im Dateidialog oder im Verzeichnisbrowser des Servers die Datei des sophisTex PPM Process Package (sie heißt etwa /STX/SOL_PPP_<version>.SAR oder ähnlich – den genauen Namen erhalten Sie vom sophisTex-Support)
- Bestätigen Sie und laden Sie die Datei
-
Paket auswählen und prüfen
- Das geladene Paket erscheint in der Liste
- Doppelklicken Sie darauf oder markieren Sie es, um die Details anzuzeigen: Version, Komponenten, Abhängigkeiten, Kompatibilität mit dem Ziel-Release
- Prüfen Sie, ob Warnungen vorliegen (z. B. erforderliche Support Packages, Konflikte)
- Ist alles in Ordnung, fahren Sie fort
-
Installation starten
-
Klicken Sie auf Continue oder Install
-
Folgen Sie dem Installationsassistenten:
- Bestätigen Sie die Einstellungen (z. B. zunächst Zielmandant = 000; die Installation wird aber in die relevanten Mandanten übernommen)
- Wählen Sie die Importoptionen (meist Standard: synchron oder im Hintergrund)
- Starten Sie den Vorgang – er kann je nach Systemgröße und Komplexität des Pakets 10–60 Minuten dauern
-
Verfolgen Sie den Fortschritt in der Statusleiste und in den Protokollen
-
Treten Fehler auf (z. B. fehlende Voraussetzungen), notieren Sie diese und beheben Sie sie (z. B. indem Sie zuerst die erforderlichen SAP-Hinweise mit SNOTE einspielen)
-
-
Nach dem Abschluss
- SAINT zeigt „Installation finished“ an (grüner Status)
- War dies die erste Installation des PPP, führen Sie die Nacharbeiten nach der Installation durch
- Führen Sie die Nacharbeiten nach dem Update durch
Optional zusätzlich: Deployment auf SAP BTP
-
An SAP Build Work Zone anmelden
- Rufen Sie den Service über Ihren SAP-BTP-Subaccount → Services → SAP Build Work Zone auf.
- Verwenden Sie einen Admin-Benutzer mit Rollen für das Content-Management und die Bearbeitung von Sites.
-
Vertrauensbeziehung zwischen UAA und IAS einrichten
-
Voraussetzung: Dieser Schritt muss abgeschlossen sein, bevor Benutzer auf Inhalte zugreifen können.
-
Im BTP Cockpit → Security → Trust Configuration:
- Richten Sie die Föderation bzw. Vertrauensbeziehung zu Ihrem Tenant von SAP Identity Authentication Service (IAS) ein.
- Folgen Sie dem Standardleitfaden von SAP: Fügen Sie IAS als Identity Provider hinzu, konfigurieren Sie die SAML-Assertions und ordnen Sie Gruppen/Rollen zu.
-
Test: Prüfen Sie, ob sich Benutzer über IAS erfolgreich an der Build Work Zone anmelden können.
-
-
BTP-Destinationen konfigurieren
-
Stellen Sie vor dem Deployment der Anwendung sicher, dass die Konnektivitätsschicht definiert ist, damit sich das MTA korrekt an vorhandene Ressourcen binden oder auf sie verweisen kann.
-
Legen Sie unter BTP Cockpit → Connectivity → Destinations die Destination für das PPP-Backend an oder prüfen Sie sie.
-
Wichtige Einstellungen:
- Name: Verwenden Sie genau den Namen, den STX vorgibt
- Type: HTTP
- Proxy Type: Internet (oder On-Premise über den Cloud Connector)
-
Additional Properties: Diese Eigenschaften müssen Sie hinzufügen, damit die Work Zone die App-Daten „sehen“ kann:
HTML5.DynamicDestination=trueWebIDEEnabled=true
-
-
PPP-Anwendung bereitstellen (MTAR)
- Stellen Sie sicher, dass die Cloud Foundry CLI und das MultiApps-Plug-in installiert sind (
cf deployverfügbar). - Melden Sie sich mit
cf loginan und wählen Sie mitcf targetdie richtige Org bzw. den richtigen Space. - Führen Sie das Deployment des gelieferten Artefakts aus:
cf deploy <your-file>.mtar. - Warten Sie auf die Bestätigung eines erfolgreichen Deployments.
- Stellen Sie sicher, dass die Cloud Foundry CLI und das MultiApps-Plug-in installiert sind (
-
PPP Content Package importieren oder aktualisieren
-
Navigieren Sie in Build Work Zone zum Content Manager.
- Bei einer Erstinstallation:
- Legen Sie ein neues Content Package an und laden Sie die bereitgestellte
package.ziphoch.
-
Wenn das PPP Content Package bereits vorhanden ist:
- Wählen Sie das vorhandene Paket und laden Sie über die Schaltfläche Update Content die neuere
package.ziphoch.
- Wählen Sie das vorhandene Paket und laden Sie über die Schaltfläche Update Content die neuere
-
Hinweis: Dieser Vorgang konfiguriert die Anwendungen, Kataloge und Launchpad-Gruppen automatisch anhand der internen Konfiguration.
-
-
Rollenzuordnungen und Site-Integration abschließen
-
Zu den Site Settings navigieren:
- Öffnen Sie das Site Directory, wählen Sie Ihre Site und wechseln Sie zu Site Settings → Assignments.
- Stellen Sie auf der Registerkarte Content Channels sicher, dass das PPP Content Package für die Site aktiviert bzw. ihr zugeordnet ist.
-
Rollen der Site zuordnen:
- Ordnen Sie auf der Registerkarte Roles der Site Settings die importierten STX-PPP-Rollen der Site zu, um die Sichtbarkeit freizugeben.
-
Benutzerberechtigung und IdP-Zuordnung:
-
Der Zugriff richtet sich nach den Rollen, die dem Benutzer im Identity Provider (IAS) zugeordnet sind.
-
Ordnen Sie Ihre IdP-Gruppen den entsprechenden BTP Role Collections zu, damit Benutzer ihre Rollen automatisch erhalten.
-
Im Paket sind die folgenden Rollen definiert:
- Admin:
stx.ppp.role.admin - Dashboard:
stx.ppp.role.dashboard - Dailys:
stx.ppp.role.dailys - Resources:
stx.ppp.role.resources - Creation:
stx.ppp.role.creation
- Admin:
-
-
-
Systeminitialisierung
- Handelt es sich um die Erstinstallation des PPP, führen Sie die Nacharbeiten nach der Installation durch.
- Führen Sie gegebenenfalls die Nacharbeiten nach dem Update durch.
-
Zugriff testen
- Veröffentlichen Sie die Site und melden Sie sich als Testbenutzer an.
- Öffnen Sie das Launchpad und prüfen Sie, ob die Kacheln erscheinen und korrekt starten.
- Prüfen Sie die Funktion auf Desktop-, Tablet- und Mobilgeräten.
Siehe auch
- Nacharbeiten nach der Installation
- Nacharbeiten nach dem Update
- Transportdateien lassen sich nicht importieren und enden auf „.txt“
- Import von Releases: Best Practices
Stichwörter
Transportimport STMS, SAINT, BTP-Deployment

