Erstinstallation / Import des PPP

Auf dieser Seite
  1. Problem
  2. Umgebung
  3. Lösung
  4. Siehe auch
  5. Stichwörter

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

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 = true
      • WebIDEEnabled = true
  • PPP-Anwendung bereitstellen (MTAR)

    • Stellen Sie sicher, dass die Cloud Foundry CLI und das MultiApps-Plug-in installiert sind (cf deploy verfügbar).
    • Melden Sie sich mit cf login an und wählen Sie mit cf target die 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.
  • 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.zip hoch.
    • 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.zip hoch.
    • 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
  • 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

Stichwörter

Transportimport STMS, SAINT, BTP-Deployment