Hotfix installieren

Hinweise

• PLANTA empfiehlt ausdrücklich Programm-Hotfixes von erfahrenen Administratoren durchführen zu lassen.
• Alle zum Einspielen der Hotfixes notwendigen Dateien stehen auf der Website PLANTA Kundenforum (Kundenforum PLANTA project Release 39.4) zum Downloaden bereit.

Information

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

Details

• Server, Python, Client und Datenbank müssen immer zur gleichen Version gehören.
  • Z.B. kann kein Client 39.3.0.3 mit Server 39.3.0.4 verwendet werden. Die Missachtung dieser Regel kann zu Problemen führen, wie z.B. dass OLEs nicht angezeigt werden, einzelne Funktionen nicht mehr gehen oder es sogar zu Datenverlust kommt.
• Alle aufgeführten Komponenten müssen gleichzeitig aktualisiert werden, somit muss PLANTA project während der Hotfix-Installation kurzzeitig offline geschaltet werden.
• Client und Server können einfach ausgetauscht werden.
• Für die Aktualisierung der Datenbank muss das entsprechende SQL-Script ausgeführt werden.

Achtung

• Unter Oracle 11.2.0.1 besteht ein Bug, der dazu führt, dass beim Einspielen von Daten mit Datapump Indexe und Constraints nicht gesetzt werden können (ORA-14102).
  • Ursache hierfür ist die doppelte Definition des Logging/Nologging-Parameters innerhalb der Create-Statements, die Datapump erzeugt.
    • Dies kann beim Einspielen von Hotfixen zu Probleme führen, da die entsprechenden Objekte nicht upgedatet werden können.

Vorbereitung

Vorgehensweise

• Prüfen der Server-, Client- und Datenbank-Version. Hierzu
  • den Client starten und anmelden
  • STRG + B drücken: Das Modul Systeminformation öffnet sich.
  • In den Feldern Client, Server und Customizing stehen die 5-stelligen Changeset-Nummern.
  • Zu welcher Version diese Changesets gehören finden Sie hier...
    • Im Feld Customizing wird zusätzlich zu der Changeset-Nummer bereits die aktuelle Version angegeben.
• Ein Backup der Datenbank, des Client- und Server-Ordners (mit allen zugehörigen Dateien, z.B. Python-Dateien im Server-Ordner) erstellen.
• Den PLANTA project-Server herunterfahren, um sicherzustellen, dass keine Anwender auf den Server zugreifen.

Durchführung

Vorgehensweise

• Aktualisieren des Servers:
  • Den gesamten Server-Ordner ersetzen.
    • Die ppms.conf oder planta.conf anpassen oder aus dem Backup wieder einkopieren.
    • Individuelle Python-Dateien können nachträglich aus dem Backup direkt übernommen werden. Angepasste Standard-Python-Dateien müssen mit den neuen Standard-Python-Dateien abgeglichen werden.
• Aktualisieren des Clients:
  • Den gesamten Client-Ordner ersetzen.
    • Individuelle IronPython-Dateien können nachträglich aus dem Backup direkt übernommen werden. Angepasste Standard-IronPython-Dateien müssen mit den neuen Standard-IronPython-Dateien abgeglichen werden.
• Aktualisieren der Datenbank:
  • Das SQL-Skript ausgeführen.
    • SQL-Skripte einzelner Versionen bauen aufeinander auf und 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 39.3.0.1 (Hotfix1), 39.3.0.2 (Hotfix2) und 39.3.0.3 (Hotfix3) ausgeführt werden.
    • Für eventuelle Fehler, die beim Laufen des Hotfix-Skripts (SQL-Skripts) auftreten, wird eine Logdatei ausgegeben. Diese wird in dem Verzeichnis abgelegt, in dem das Skript ausgeführt wird.
• Starten des PLANTA project-Servers
• Prüfen, ob eventuell Teile des In Case of Update-Topics und, wenn vorhanden, individuelle In Case of Updates durchzuführen sind.

Hinweis

• Nach Einspielen eines Hotfixes für alle Datenbank-Instanzen eine Relationsprüfung durchführen.

---

Siehe auch: InstallationsAnleitung, Release Notes