[16.0.0.3 und höher]

Befehl "pluginUtility"

Wenn der Liberty-Server die Plug-in-Konfigurationsdatei automatisch generiert, können Sie mit dem Befehl "pluginUtility" die Plug-in-Konfigurationsdateien zusammenstellen und zusammenführen. Sie können zusätzlich den Befehl pluginUtility verwenden, um die Plug-in-Konfigurationsdatei manuell zu generieren.

Syntax

Die Befehlssyntax ist wie folgt:

pluginUtility Aktion [Optionen]
Für die Variable Aktion kann einen der folgenden Werte verwendet werden.
help
Zeigt Hilfeinformationen für eine angegebene Aktion an.

Sie können Hilfetext für den Befehl pluginUtility anzeigen oder Hilfetext für bestimmte Aktionen, wie z. B. die Aktion zum Zusammenführen (merge).

merge
Führt die Web-Server-Plug-in-Konfigurationsdateien zu einer einzigen Datei zusammen.
[16.0.0.4 und höher]
generate
Erstellt die Plug-in-Konfigurationsdatei mithilfe dieses Dienstprogramms.

Optionen

Die folgenden Optionen sind für den Befehl pluginUtility verfügbar:
[16.0.0.4 und höher]--server=Server-ID für einen lokalen Server oder --server=Benutzer:Kennwort@Host:Port für einen fernen Server
[16.0.0.4 und höher]Gilt nur für die Aktion "generate" und ist erforderlich, wenn Sie die Aktion "generate" mit dem Befehl pluginUtility angeben.
  • Für einen lokalen Server ist die Serveroption der Servername.
  • Für einen fernen Server ist die Serveroption Benutzer:Kennwort@Host:Port.
  • Der Server muss sowohl für einen lokalen als auch einen fernen Server aktiv sein.
    user
    Ein Administrator für den Zielserver. Das Dienstprogramm fragt einen Wert ab, wenn Sie keinen angeben. Verwenden Sie keinen Doppelpunkt (:) für Benutzer.
    password
    Das Kennwort des Benutzers mit Administratorberechtigung für den Zielserver. Das Dienstprogramm fragt zweimal einen Wert ab, wenn Sie keinen angeben. Ihre Kennworteinträge müssen übereinstimmen.
    Wichtig: Sie geben bei dieser Option Benutzer und Kennwort an, damit diese Werte bei Angabe an der Befehlszeile funktionieren. Der Zielserver überprüft die Werte, die Sie für Benutzer und Kennwort angeben, mit den Werten, die Sie an der Befehlszeile eingeben.
    Tipp: Für Fernanforderungen können Sie die Benutzer-ID und das Kennwort in der Datei server.xml des Zielservers codieren.
    Beispiel:
    <quickStartSecurity
    userName="AdminUser"
    userPassword="AdminPassword" />
    host
    Der Host für den Zielserver. Verwenden Sie nicht das @-Symbol im Hostwert. Ein fehlender Hostwert führt zu einem Fehler.
    port
    Die Portnummer für den Zielserver. Ein fehlender Portwert führt zu einem Fehler.
    Achtung: Wenn der angegebene Server ein ferner Server ist, wird der Benutzer aufgefordert, ein SSL-Zertifikat zu akzeptieren, damit die Anforderung ausgeführt werden kann. Wenn SSL-Zertifikate automatisch akzeptiert werden sollen, setzen Sie die JVM-Eigenschaft "com.ibm.webserver.plugin.utility.autoAcceptCertificates" auf true.
[16.0.0.4 und höher]
--cluster=Clustername
Gilt nur für die Aktion "generate" und ist erforderlich, wenn Sie eine Plug-in-Konfigurationsdatei für einen Cluster-Server mithilfe dieses Dienstprogramms generieren. Geben Sie den Namen des Server-Clusters an.

Wenn Sie die Option --cluster angeben, müssen Sie den Verbundcontroller mit der Option --server angeben.

Damit ein Server im Cluster in die Plug-in-Konfigurationsdatei eingeschlossen wird, muss er aktiv sein und mit einem Verbundcontroller verknüpft.

--sourcePath=Verzeichnis|durch Kommas getrennte Liste
Erforderliche Option, die nur für die Aktion "merge" gilt. Gibt die Position des Quellenverzeichnisses an, das alle Plug-in-Konfigurationsdateien enthält. Wenn Sie die zusammenzuführenden Plug-in-Dateien angeben möchten, geben Sie eine durch Kommas getrennte Liste mit den Namen der Quellen-Plug-in-Dateien mit dem vollständigen Dateipfad an.
--targetPath=Verzeichnis|vollständiger Pfadname
[16.0.0.4 und höher]Optionale Option, die für die Aktionen "merge" und "generate" gilt.

Für die Aktion "generate" wird die Plug-in-Konfigurationsdatei standardmäßig im aktuellen Verzeichnis mit dem Namen Clustername-plugin-cfg.xml für eine Clusteranforderung und mit dem Namen plugin-cfg.xml für eine Nicht-Clusteranforderung generiert. Sie können entweder den Namen des Verzeichnisses angeben, in dem die Datei gespeichert werden muss, oder Sie geben einen vollständig qualifizierten Dateinamen an. Das Verzeichnis muss vorhanden sein. Die neue Datei ersetzt eine vorhandene Datei.

Für die Aktion "merge" wird die zusammengeführte Plug-in-Konfigurationsdatei standardmäßig im aktuellen Verzeichnis unter dem Namen merged-plugin-cfg.xml generiert. Sie können entweder den Namen des Zielverzeichnisses für die Datei merged-plugin-cfg.xml oder einen vollständig qualifizierten Dateinamen angeben. Das Verzeichnis muss vorhanden sein. Wenn eine Datei mit dem Namen merged-plugin-cfg.xml oder der angebene Dateiname bereits vorhanden ist, wird der Inhalt der Datei überschrieben.

Syntax

In den folgenden Beispielen wird die richtige Syntax veranschaulicht:

pluginUtility help
pluginUtility help merge
pluginUtility merge --sourcePath=C:/plugins
pluginUtility merge --sourcePath=C:/plugins/plugin-cfg.xml,C:/plugins/Aplugin-cfg.xml,C:/other/plugin-cfg.xml
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir/myMergedPluginCfg.xml
[16.0.0.4 und höher]
pluginUtility help generate
pluginUtility generate --server=myController --cluster=myCluster --targetpath=./pluginFile/plugin-cfg.xml
pluginUtility generate -–server=userName:mypassword@myControllerHost:9443 --cluster=myCluster --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate –-server=myServer --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate –-server=userName:mypassword@testHost:9443 --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate --server=userName:@testHost:9443
Anmerkung: For the pluginUtility generate --server=userName:@testHost:9443 command, the user is prompted for the password.
Tipp: Wenn der Optionswert Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen. Wenn der Dateipfad für die Option --sourcePath beispielsweise C:\Program Files\myFiles\plugin-cfg.xml ist, geben Sie im Befehl Folgendes an: --sourcePath="C:/Program Files/myFiles/plugin-cfg.xml".

Symbol das den Typ des Artikels anzeigt. Referenzartikel



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