Hotfix installieren

Information

• Bei den Hotfix/Patches unterscheidet man zwischen:
  • Aktualisierung von Server, Client und Python (erfolgt durch einen Austausch von Programmdateien/Ordner)
  • Aktualisierung der Datenbank (erfolgt durch das Ausführen eines SQL-Skripts)
    • Hinweis: Nicht jeder Hotfix enthält zwingend alle Komponenten, oftmals ist beispielsweise kein SQL-Skript enthalten.

Details

• Server, Python, Client und Datenbank müssen immer zur gleichen Version gehören.
• Alle aufgeführten Komponenten müssen gleichzeitig aktualisiert werden, somit muss PLANTA project während der Hotfix-Installation kurzzeitig offline geschaltet werden.
• Client, Server und Python können einfach ausgetauscht werden.
• Die Datenbankaktualisierungen (versionierte SQL-Skripte) bauen aufeinander auf, d. h. die SQL-Skripte müssen, dem Versionierungsschema folgend, nacheinander ausgeführt werden.
  • Beispiel: Möchte man von Version 39.3.0.0 auf 39.3.0.3 wechseln, müssen nacheinander die Skripte von 3.0.1, 3.0.2 und 3.0.3 ausgeführt werden.

Tipp

• Vor dem Durchführen eines Hotfixes wird empfohlen
  • ein Backup der Datenbank zu erstellen.
  • die zu ersetzenden Dateien und Ordner (Client, Server, Python) mit dem bak-Kürzel umzubenennen.

Vorbereitung

Vorgehensweise

• Prüfen der Server und Client-Version. Hierzu
  • den Client starten und anmelden
  • STRG+B drücken: die Systeminformation öffnet sich.
  • In den Feldern Client und Server stehen die 5-stelligen Changeset-Nummern.
  • Zu welcher Version diese Changesets gehören finden Sie hier...
• Prüfung der Datenbank-Version. Hierzu
  • die nachfolgende Query in der zu aktualisierenden Datenbank ausführen:

    select DI059300 from dt345;  

  • Diese Query liefert einen String, der die Version (und damit auch das Changeset) beinhaltet.
    • Hinweise
      • In einem System mit der Datenbank-Version 39.3.0.0 liefert die Query die Fehlermeldung ORA-00904: "DI059300": ungültiger Bezeichner, da dieses Dataitem erst mit 39.3.0.1 eingeführt wurde.
      • Gehört zu einem Hotfix keine Änderung an der Datenbank, steht in dem String eine ältere Version. Beispiel: Zu den Versionen 39.3.0.2 und 39.3.0.3 gehört das Datenbank-Changeset 30613. D.h. in der Version 39.3.0.3 steht im String weiterhin PLANTA project 3.0.2 mars 30613.
• Des Weiteren muss sichergestellt werden, dass keine Anwender auf den Server zugreifen, d.h. der PLANTA project-Server muss vor der Aktualisierung runtergefahren werden. Hierzu
  • auf Start Ausführen klicken.
  • In das Feld Öffnen:

    services.msc

    eintragen und mit OK bestätigen.
  • Rechtsklick auf den PLANTA project-Server (z.B.: PLANTA PPMS (001) ) und im Kontextmenu auf Beenden klicken.

Durchführung

Vorgehensweise

• Aktualisieren des Servers:
  • planta_server und ppmsd müssen ersetzt werden.
• Aktualisieren des Clients:
  • Der gesamte Ordner Client muss ersetzt werden.
• Aktualisieren von Python:
  • Den Ordner Py auf dem Server ersetzen
    • Individuell angelegte oder angepasste Dateien müssen nachträglich wieder übernommen werden.
• Aktualisieren der Datenbank:
  • Dazu muss das SQL-Skript ausgeführt werden.
    • Ab Version 39.3.1.0 wird eine Logdatei für Fehler, die beim Laufen des Hotfix-Skripts (SQL-Skripts) auftreten, ausgegeben. Diese wird in dem Verzeichnis abgelegt, wo das Skript ausgeführt wird.
• Starten des PLANTA project-Servers (z.B.: PLANTA PPMS (001) ).

---

Siehe auch: InstallationsAnleitung, Release Notes