Kundencustomizing-Deployment

• Das Customizing-Deployment dient dem Ausrollen des Customizings, z.B. aus einem Entwicklungssystem beim Kunden in dessen Produktivsystem. Hierbei wird u.a. das Customizing im Zielsystem unter Verwendung des Datenbank-Exports/-Imports vollständig durch einen Export aus dem Quellsystem ersetzt.

• Quell- und Zielsystem müssen kongruent sein, d.h.
  • der Programmstand beider Systeme muss identisch sein und alle Migrationspakete müssen denselben Stand haben
  • das Datenbankschema des Zielsystems muss auf dem Stand des Quellsystems sein

• SQL-Dateien (Beispiel: sql_planta_1_1.sql)
• Python-Verzeichnis des Servers (Beispiel: py.zip)
• Customizing-Deployment-Dateien (Beispiel: cu_deployment_2015_02_04.zip)

Vorgehensweise beim Export

• Für den Export gibt es eine Parameterdatei in 2 Ausführungen, die alle notwendigen Daten bereitstellt.
  • Die Dateien befinden sich im Server-Installationsverzeichnis unter config/export/customizing_deployment_*.par.
  • Die Datei config/export/customizing_deployment_venus.par ist für Systeme mit einer Datenbank DB 39.5.x.
  • Die Datei config/export/customizing_deployment_voe.par ist für Systeme mit der Datenbank DB 39.4.4.0.

./planta_export.sh --output-file /tmp/cu_deployment_2015_02_04.zip  @config/export/customizing_deployment_venus.par

Vorgehensweise beim Import

• Für den Import sind mehrere Schritte erforderlich.
• Die zugehörigen Parameterdateien befinden sich im Unterverzeichnis config/import/customizing_deployment.

• Den PLANTA-Dienst stoppen.

• SQL-Plus starten und mit dem Datenbank-User der PLANTA-Applikation verbinden

  CODE

  sqlplus DB-Benutzer/Passwort@DB-SID

• Gelieferte SQL-Datei(en) ausführen

  CODE

  @ sql_planta_1_1.sql

• PLANTA liefert ein ZIP-Archiv mit den Customizing Deployment-Dateien (Beispiel: cu_deployment_2015_02_04.zip).
  • Dieses ZIP-Archiv muss nicht entpackt werden. Das Entpacken wird durch das Import-Verfahren von PLANTA automatisch durchgeführt.
• Das Zip-Archiv an eine beliebige Stelle auf dem Applikationsserver ablegen (Beispiel: /tmp/)
• In das Applikationssverzeichnis PLANTA (Beispiel: /planta/app/Lief) wechseln.
• Die folgenden Importbefehle in genau dieser Reihenfolge ausführen:

./planta_import.sh --input-file /tmp/cu_deployment_2015_02_04.zip @config/import/customizing_deployment/01_replace_q1b_q2b.par

./planta_import.sh --input-file /tmp/cu_deployment_2015_02_04.zip @config/import/customizing_deployment/02a_replace_module_variants.par

./planta_import.sh --input-file /tmp/cu_deployment_2015_02_04.zip @config/import/customizing_deployment/02b_add_module_variant_itexts.par

# Hier nur die der Datenbank entsprechende Datei nehmen
./planta_import.sh --input-file /tmp/cu_deployment_2015_02_04.zip @config/import/customizing_deployment/03_replace_interfaces_venus.par
./planta_import.sh --input-file /tmp/cu_deployment_2015_02_04.zip @config/import/customizing_deployment/03_replace_interfaces_voe.par

./planta_import.sh --input-file /tmp/cu_deployment_2015_02_04.zip @config/import/customizing_deployment/04_replace_process_models.par

• Die Datenbank und das Python-Verzeichnis des Servers sichern (z.B. "py" in "py_alt" umbenennen").
• Das Zip-Archiv mit dem Python-Verzeichnis entpacken.
• Alle Unterverzeichnisse des neuen "py"-Verzeichnisse in das "py"-Verzeichnis des Servers kopieren.
  • Error rendering macro 'fontawesome-macro' : Page loading failed
    Die Verzeichnisstruktur hat sich mit Server 39.5.18 geändert und die Dateien von einem älteren Release können nicht einfach einkopiert werden, sondern müssen auf die richtigen Verzeichnisse verteilt werden. Siehe auch: Ordner-Struktur.

• Den PLANTA-Dienst starten.
  • Das target-Verzeichnis wird mit aktuellen POJO-Klassen neu generiert.

• Werden beim Import die Inhalte der Datentabellen übertragen, die eine Autonummer besitzen, deren Zählerstände jedoch nicht, müssen die Zählerstände anschließend manuell angepasst werden.
• Werden beim Import History-Datentabellen (_HIS) übernommen, muss die HIBERNATE_SEQUENCE im Zielsystem manuell auf den höchsten Stand der in den History-Tabellen vorhandenen Daten gesetzt werden.
• Werden die Schnittstellen-Daten getauscht, gehen die archivierten Schnittstellen-Konfigurationen verloren.
  • Dies schließt sämtliche Logging-Daten, Parameter, sowie Pool-Datensätze ein!
• Der PLANTA-Import löscht keine Schnittstellen-Mappings, sondern importiert nur neue bzw. aktualisiert vorhandene Mappings. Die betroffenen Mappings müssen nach dem Import manuell gelöscht werden.
• Wenn beim Import Fehler aufgrund von Datenkorruptionen auftreten, kann das Modul Datenbank-Konsistenz überprüfen zur Prüfung bzw. Korrektur genutzt werden.