Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

4.2.2.3. Zurücksetzen der Anwendung eines Patches in Zip-Form mithilfe des Patch Management Systems

Zusammenfassung

Das JBoss EAP 6 Patch Management System kann dazu verwendet werden, um die Anwendung eines bereits angewendeten Zip-Patches zurückzusetzen, entweder mithilfe des Management-CLI oder der Management-Konsole.

Warnung

Das Zurücksetzen der Anwendung eines Patches mithilfe des Patch Management Systems ist nicht als allgemeine Deinstallationsfunktionalität gedacht. Sie ist nur zur Verwendung unmittelbar nach der Anwendung eines Patches gedacht, der unerwünschte Folgen mit sich gebracht hat.

Wichtig

Das Patch Management System ist ein Feature, das in JBoss EAP 6.2 hinzugefügt wurde. Für Versionen vor der JBoss EAP vor 6.2 ist der Vorgang für das Zurücksetzen von Patches im Zip-Format anders. Sehen Sie bitte in der Dokumentation der betreffenden Version nach unter https://access.redhat.com/site/documentation/.

Voraussetzungen

  • Ein Patch wurde zuvor mittels des JBoss EAP 6 Patch Management Systems angewendet.
  • Zugriff auf das Management-CLI oder die Management-Konsole für den JBoss EAP 6 Server. Siehe Launch the Management-CLI oder Log in to the Management Console im Administration and Configuration Guide.

Warnung

Seien Sie bei beiden Verfahren vorsichtig bei der Festlegung des Werts der Option Reset Configuration:
Falls auf TRUE eingestellt, setzt der Patch-Zurücksetzungsvorgang auch die JBoss EAP 6 Serverkonfigurationsdateien auf deren Prä-Patch-Status zurück. Sämtliche Änderungen, die nach der Anwendung des Patches an den JBoss EAP 6 Serverkonfigurationsdateien vorgenommen wurden, gehen verloren.
Falls auf FALSE eingestellt, werden die Serverkonfigurationsdateien nicht zurückgesetzt. In dieser Situation ist es möglich, dass der Server nach dem Zurücksetzen nicht startet, da der Patch möglicherweise Konfigurationen wie Namespaces geändert hat, die nun nicht mehr gültig sind und manuell korrigiert werden müssen.

Prozedur 4.3. Zurücksetzen eines Patches auf einer JBoss EAP 6 Serverinstanz mittels des Management-CLI

  1. Vom Management-CLI verwenden Sie den Befehl patch info zum Auffinden der ID des zurückzusetzenden Patches.
    • Für kumulative Patches ist die Patch ID der Wert der ersten cumulative-patch-id, die in der patch info-Ausgabe angezeigt wird.
    • Für individuelle Sicherheits- oder Fehlerbehebungs-Patches sind die Patch IDs als Wert des ersten patches gelistet, der in der patch info-Ausgabe angezeigt wird, wobei der aktuellste individuelle Patch zuerst gelistet wird.
  2. Vom Management-CLI setzen Sie den Patch mit der betreffenden Patch ID vom vorherigen Schritt zurück. 
    [standalone@localhost:9999 /] patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE
    Das patch-Tool meldet eine Warnung, falls bei der Zurücksetzung des Patches Konflikte auftreten. Unter Abschnitt 4.2.2.1, »Das Patch Management System« finden Sie die verfügbaren Switches des patch-Befehls, mit denen Sie den Befehl erneut ausführen können, um Konflikte aufzulösen.
  3. Starten Sie den JBoss EAP 6 Server neu, damit das Zurücksetzen des Patches wirksam wird: 
    [standalone@localhost:9999 /] shutdown --restart=true

Prozedur 4.4. Zurücksetzen eines Patches auf einer JBoss EAP 6 Serverinstanz mittels der Management-Konsole

  1. In der Management-Konsole:
    • Für einen Standalone Server: Wählen Sie den Runtime Tab oben im Bildschirm und klicken Sie anschließend auf Patch Management.
    • Für eine Managed Domain: Klicken Sie auf den Domain Tab oben im Bildschirm, wählen Sie aus dem Host Drop-Down-Menü den gewünschten Host, und klicken Sie anschließend auf Patch Management.
  2. Wählen Sie aus der Tabelle Recent Patch History den Patch, den Sie zurücksetzen möchten, und klicken Sie anschließend auf Rollback.
    1. Wählen Sie für einen Managed Domain Host auf dem nächsten Bildschirm, ob die Server auf dem Host heruntergefahren werden sollen, und klicken Sie auf Next.
  3. Wählen Sie die gewünschten Optionen für die Zurücksetzung und klicken Sie auf Next.
  4. Bestätigen Sie die Optionen und den zurückzusetzenden Patch und klicken Sie auf Next.
    1. Falls die Option Override all nicht ausgewählt wurde und es beim Zurücksetzen des Patches zu Konflikten kommt, wird eine Warnung angezeigt. Klicken Sie auf View error details, um Details der Konflikte anzuzeigen. Sie können in diesem Fall entweder den Vorgang abbrechen oder auf Choose Options klicken und den Vorgang mit markierter Override all Option erneut versuchen. Falls Sie sich dazu entscheiden, die Konflikte zu überschreiben, werden bei der Zurücksetzung sämtliche Benutzeränderungen überschrieben.
  5. Nachdem der Patch erfolgreich zurückgesetzt wurde, wählen Sie, ob der JBoss EAP 6 Server jetzt neu gestartet werden soll, damit die Änderungen wirksam werden. Klicken Sie abschließend auf Finish.
Ergebnis

Der Patch und optional auch die Serverkonfigurationsdateien werden an der JBoss EAP 6 Serverinstanz zurückgesetzt.

Fehler melden