Befehl GenPluginCfg

Mit dem Befehl GenPluginCfg kann die Konfigurationsdatei für die Web-Server-Plug-ins von WebSphere, plugin-cfg.xml, erneut generiert werden.

Der Artikel Befehlstools verwenden beschreibt, wo dieser Befehl ausgeführt werden muss.

Vorsicht:
Bei der erneuten Generierung der Plug-in-Konfiguration können manuell vorgenommene Konfigurationsänderungen, die Sie unter Umständen beibehalten möchten, überschrieben werden. Bevor Sie diese Task ausführen, sollten Sie sich mit den Auswirkungen vertraut machen, die in Web-Server-Plug-in implementieren beschrieben sind.
Fehler vermeiden Fehler vermeiden: Die topologiezentrierte oder globale Plug-in-Konfiguration wird nicht mehr verwendet. Statt dessen sollte die in Web-Server-Plug-in implementieren beschriebene anwendungszentrierte Konfiguration verwendet werden. Für eine bestehende topologiezentrierte Konfiguration können Sie Sie die globale Datei plugin-cfg.xml über die Administrationskonsole oder durch Ausführen des Befehls GenPluginCfg für alle Cluster in einer Zelle aktualisieren. Allerdings müssen Sie die Datei config/cells/plugin-cfg.xml löschen, bevor Sie die globale Datei plugin-cfg.xml aktualisieren. Wenn Sie die Datei config/cells/plugin-cfg.xml nicht löschen, werden nur die neuen Eigenschaften mit ihren Werten in die globale Datei plugin-cfg.xml aufgenommen. Alle Aktualisierungen, die an den vorhandenen Plug-in-Eigenschaftswerten vorgenommen wurden, werden der globalen Datei plugin-cfg.xml nicht hinzugefügt. gotcha
Anmerkung: Weil der Befehl GenPluginCfg in einer eigenen JVM (Java™ Virtual Machine) anstatt in der WebSphere Application Server-JVM ausgeführt wird, kann der Befehl möglicherweise nicht auf andere Klassendateien zugreifen. Wenn dieses Problem bei Ausführung des Befehls GenPluginCfg auftritt, können Sie statt dessen das Script httpPluginManagement.py ausführen, um eine anwendungszentrierte Plug-in-Konfiguration zu generieren. Dieses Script verwendet, wsadmin, um die Plug-in-Generierung zu starten. Weitere Informationen hierzu finden Sie im Artikel Script "httpPluginManagement.py".

Syntax

Verwenden Sie zum erneuten Generieren der Plug-in-Konfiguration die folgenden Methoden:
  • [AIX Solaris HP-UX Linux Windows]Klicken Sie in der Administrationskonsole auf Server > Servertypen > Web-Server, wählen Sie einen Web-Server aus, und klicken Sie anschließend auf Plug-in generieren.
  • Setzen Sie den folgenden Befehl ab:
    [AIX Solaris HP-UX Linux Windows]
    Stammverzeichnis_des_Anwendungsservers/bin/GenPluginCfg.sh|bat
    Beide Methoden erstellen eine Datei plugin-cfg.xml im ASCII-Format, dem korrekten Format für die Ausführung in einer verteilten Umgebung.
    [IBM i]
    Stammverzeichnis_des_Anwendungsservers/bin/GenPluginCfg
    Diese Methode zum erneuten Generieren der Plug-in-Konfiguration erstellt eine Datei plugin-cfg.xml im ASCII-Format, dem richtigen Format für die Ausführung in einer IBM i-Umgebung.
    [z/OS]
    Stammverzeichnis_des_Anwendungsservers/bin/GenPluginCfg.sh
    Diese Methode für die Neugenerierung der Plug-in-Konfiguration erstellt eine Datei plugin-cfg.xml im UTF-8-Format, dem richtigen Format für die Ausführung in einer z/OS-Umgebung.

[AIX Solaris HP-UX Linux Windows][IBM i]Sie können die Option -profileName verwenden, um das Profil des Anwendungsserverprozesses in einer Installation mit mehreren Profilen zu definieren. Die Option -profileName ist in einer Umgebung mit nur einem Profil nicht erforderlich. Standardmäßig wird für diese Option das Standardprofil verwendet.

Wenn der Befehl GenPluginCfg mit der Option -webserver.name Web-Servername ausgeführt wird, generiert wsadmin eine Plug-in-Konfigurationsdatei für den Web-Server. Die Einstellungen in der generierten Konfigurationsdatei basieren auf der Liste der Anwendungen, die im Web-Server implementiert sind. Wenn Sie diesen Befehl ohne die Option "-webserver.name Web-Servername" ausführen, wird die Plug-in-Konfigurationsdatei auf der Basis der Topologie generiert.

Parameter

Die folgenden Optionen sind für den Befehl GenPluginCfg verfügbar:

-config.root Konfigurationsstammverzeichnis
Die Standardeinstellung ist CONFIG_ROOT. Zum Abrufen dieser Umgebungsvariablen wird der Befehl setupCmdLine aufgerufen.
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName
[AIX Solaris HP-UX Linux Windows][IBM i]Definiert das Profil des Anwendungsserverprozesses in einer Installation mit mehreren Profilen. Die Option -profileName ist in einer Umgebung mit nur einem Profil nicht erforderlich. Standardmäßig wird für diese Option das Standardprofil verwendet.
-cell.name Zelle
Die Standardeinstellung ist WAS_CELL. Zum Abrufen dieser Umgebungsvariablen wird der Befehl setupCmdLine aufgerufen.
-node.name Knoten
Die Standardeinstellung ist WAS_NODE. Zum Abrufen dieser Umgebungsvariablen wird der Befehl setupCmdLine aufgerufen.
-webserver.name webserver1
Erforderlich für das Erstellen einer Plug-in-Konfigurationsdatei für einen bestimmten Web-Server.
-propagate yes/no
Nur gültig, wenn die Option webserver.name angegeben und der Web-Server auf dem lokalen System oder auf einem fernen nicht verwalteten Knoten installiert ist. Andernfalls müssen Sie die Datei plugin-cfg.xml manuell aus dem Verzeichnis Stammverzeichnis_des_Anwendungsservers/profiles/Profilname/config/cells/Zellenname/nodes/Knotenname/servers/Name_des_Web-Servers in das Verzeichnis Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers des Plug-in-Verzeichnisses des fernen Web-Servers kopieren. Der Standardwert ist "no".
-propagateKeyring yes/no
Nur gültig, wenn die Option webserver.name angegeben und der Web-Server auf dem lokalen System installiert ist. Der Standardwert ist no.
-cluster.name cluster1,cluster2 | ALL
Optionale Liste mit Clustern. Wird ignoriert, wenn die Option webserver.name angegeben ist.
-server.name server1,server2
Optionale Liste mit Servern. Erforderliche für die Generierung von Einzelserver-Plug-ins. Wird ignoriert, wenn die Option webserver.name angegeben ist.
-output.file.name Dateiname
Standardmäßig wird die Datei "Konfigurationsstammverzeichnis/plugin-cfg.xml" verwendet. Wird ignoriert, wenn die Option webserver.name angegeben ist.
-destination.root Stammverzeichnis
Installationsstammverzeichnis der Maschine, auf der die Konfiguration verwendet wird. Wird ignoriert, wenn die Option webserver.name angegeben ist.
-destination.operating.system windows/unix
Betriebssystem der Maschine, auf der die Konfiguration verwendet wird. Wird ignoriert, wenn die Option webserver.name angegeben ist.
-force yes
Erstelle eine neue Konfiguration statt zu versuchen, eine vorhandene Konfiguration zusammenzuführen, wenn der Befehl für eine zellenweite Dateierstellung abgesetzt wird.
-debug yes/no
Der Standardwert ist no.
-help
Gibt eine Anweisung zur Verwendung des Befehls aus.
-?
Gibt eine Anweisung zur Verwendung des Befehls aus.

Einsatzszenario

Führen Sie zum Generieren einer Plug-in-Konfiguration für alle Cluster in einer Zelle den folgenden Befehl aus:

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name NetworkDeploymentCell
[IBM i][z/OS]
GenPluginCfg.sh -cell.name NetworkDeploymentCell

Führen Sie zum Generieren einer Plug-in-Konfiguration für einen einzelnen Server den folgenden Befehl aus:

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName
[IBM i][z/OS]
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName

Führen Sie zum Generieren einer Plug-in-Konfiguration für einen Web-Server den folgenden Befehl aus:

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName
[IBM i][z/OS]
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_genplugincfg1
Dateiname:rxml_genplugincfg1.html