Angepasste Widgets einzeln in Heritage Process Portal-Spaces deinstallieren

Verwenden Sie diese Prozedur, um ein angepasstes Widget, das nicht als einziges Widget im zugehörigen Katalog definiert ist, in einem Space zu deinstallieren.

Informationen zu diesem Vorgang

Sie können ein Widget auf eine der folgenden Weisen aus einem Space entfernen:
  • Inaktivieren Sie das Widget. Dadurch wird seine Registrierung aufgehoben, sodass es den Benutzern nicht länger zur Verfügung steht, während der Widget-Code weiterhin auf dem Server erhalten bleibt. Wenn Sie ein von IBM® Business Process Manager Advanced bereitgestelltes Widget entfernen möchten, ist dies die korrekte Vorgehensweise. Informationen hierzu enthält Widgets in Heritage Process Portal-Spaces inaktivieren.
  • Deinstallieren Sie das angepasste Widget sowie den Katalog, in dem es enthalten ist. Dadurch werden das Widget (und alle anderen Widgets im Katalog) sowie der Katalog selbst vollständig entfernt. Informationen hierzu enthält Angepasste Widgets und Kataloge in Heritage Process Portal-Spaces deinstallieren.
  • Deinstallieren Sie nur das angepasste Widget. Dadurch wird das Widget zwar aus dem Katalog entfernt, aber der Katalog an sich bleibt erhalten. Verwenden Sie diese Methode nicht, wenn Sie das letzte im Katalog definierte Widget deinstallieren. Deinstallieren Sie stattdessen das Widget mit dem zugehörigen Katalog wie in der Prozedur unter Angepasste Widgets und Kataloge in Heritage Process Portal-Spaces deinstallieren beschrieben.
Bei der Installation des angepassten Widgets finden die folgenden Aktionen statt:
  • Die EAR-Datei für das Widget wird im Verzeichnis profilstammverzeichnis/installedApps/knotenname installiert.
  • Die Katalogdatei für das Widget wird zu dem Verzeichnis profilstammverzeichnis/BusinessSpace/knotenname/servername/mm.runtime.prof/config hinzugefügt bzw. dort aktualisiert. Durch diesen Vorgang wird das Widget registriert. Der Katalog in Ihrer Datei wird außerdem mit einem Tag include zum Standardkatalog hinzugefügt.
  • Die vom Widget verwendeten Endpunkte (sofern das Widget diese verwendet und angepasste Endpunkte benötigt werden) werden zum Verzeichnis profilstammverzeichnis/BusinessSpace/knotenname/servername/mm.runtime.prof/endpoints hinzugefügt bzw. dort aktualisiert.
  • Die Hilfedateien für das Widget, sofern das Widget die Dokumentation als Hilfe verwendet, werden zum Verzeichnis profilstammverzeichnis/config/BusinessSpace/help/eclipse/plugins hinzugefügt.

Wenn Sie ein angepasstes Widget einzeln deinstallieren, löschen Sie die Widget-Dateien und entfernen die Definition für dieses Widget aus der Katalogdatei. Außerdem aktualisieren Sie die Endpunkte und die Widget-Hilfe, wenn Sie diese in die Deinstallation einbeziehen.

Vorgehensweise

  1. Deinstallieren Sie die WAR-Datei, die das Widget enthält.
  2. Bearbeiten Sie die XML-Katalogdatei (Widget-Registrierung), die das Widget enthält, und entfernen Sie deren Einträge. Kopieren Sie die bearbeitete Datei in ein Verzeichnis namens catalog.
  3. Wenn das Widget über eine Hilfe verfügt, führen Sie die folgenden Schritte aus:
    1. Kopieren Sie das Dokumentations-Plug-in mit der Hilfe aus dem Verzeichnis profilstammverzeichnis/config/BusinessSpace/help/eclipse/eclipse/plugins.
    2. Bearbeiten Sie die XML-Datei für die Navigation und löschen Sie dort die Einträge für das Widget.
    3. Öffnen Sie die Datei doc.zip und löschen Sie die Hilfedateien für das Widget. Wenn andere Dateien Hyperlinks enthalten, die auf die Hilfe für das Widgets verweisen, löschen Sie diese Links in den betreffenden Dateien.
    4. Kopieren Sie das Dokumentations-Plug-in in ein Verzeichnis help/eclipse/plugins.
      Anmerkung: Wenn weitere Dokumentations-Plug-ins mit Hyperlinks auf die Plug-ins, die Sie gerade löschen, vorhanden sind, müssen Sie die anderen Plug-ins separat aktualisieren. Informationen hierzu enthält der letzte Schritt im Abschnitt Veraltet: Plug-in für die Dokumentation erstellen.
  4. Komprimieren Sie die Katalog- und Hilfeverzeichnisse. Stellen Sie sicher, dass die Struktur der ZIP-Datei die folgenden Elemente enthält:
    • catalog\catalog_name.xml
    • help\eclipse\plugins\*
  5. Wechseln Sie an einer Eingabeaufforderung zum Verzeichnis profilstammverzeichnis/bin oder clusterstammverzeichnis/bin.
  6. Geben Sie wsadmin.bat -conntype NONE und anschließend den entsprechenden Befehl ein:
    • Zum Deinstallieren der Widgets in einer Umgebung ohne Clustering geben Sie folgenden Befehl ein: $AdminTask updateBusinessSpaceWidgets {-nodeName knoten -serverName server -widgets vollständiger_pfad}
    • Zum Deinstallieren der Widgets in einer Clusterumgebung geben Sie folgenden Befehl ein: $AdminTask updateBusinessSpaceWidgets {-clusterName cluster -widgets vollständiger_pfad}
    Die Angabe vollständiger_pfad gibt den Namen und die Speicherposition der von Ihnen erstellten ZIP-Datei an.

    Informationen zum Befehl updateBusinessSpaceWidgets enthält Befehl 'updateBusinessSpaceWidgets'.

  7. Geben Sie Exit ein.
  8. Melden Sie sich bei Heritage Process Portal an und löschen Sie das Widget aus allen Schablonen und Spaces, in denen es verwendet wird. Wenn Sie das Widget nicht löschen, wird anhand einer Platzhaltergrafik und einer Nachricht darauf hingewiesen, dass das Widget nicht verfügbar ist.
Übergeordnetes Thema: Widgets von Heritage Process Portal-Spaces entfernen(veraltet)