[8.5.5.6 oder höher]

Dateien mit einem einzigen REST-Aufruf auf mehrere registrierte Hosts hochladen

Sie können Dateien von einem Verbundcontroller auf mehrere registrierte Hosts eines Verbunds hochladen, indem Sie die REST-API POST aufrufen. Die Dateiübertragungsoperationen finden innerhalb eines IBM JMX-REST-Connectors statt.

Vorbereitende Schritte

Erstellen Sie einen Verbundcontroller. Nähere Informationen hierzu finden Sie unter Liberty-Verbund konfigurieren.

Registrieren Sie jeden fernen Host-Computer beim Verbundcontroller. Informationen hierzu finden Sie unter Host-Computer bei einem Liberty-Verbund registrieren.

Vorgehensweise

  1. Optional: Um die Dokumentation zu den REST-APIs zu lesen, navigieren Sie in Ihrem Browser zu https://Name_des_Controller-Hosts:Name_des_Controller-Ports/IBMJMXConnectorREST/api und geben Sie dann zur Anmeldung die Benutzer-ID und das Kennwort des Controller-Administrators ein. Der Controller muss aktiv sein, damit die Dokumentation zu den REST-APIs angezeigt werden kann.

    In den Abschnitten Dateiübertragung und Routing sind die APIs beschrieben, die zur Übertragung von Dateien zwischen dem Verbundcontroller und einem Member-Server oder einem registrierten Port verwendet werden.

    Das Feature collectiveController-1.0 aktiviert das Feature restConnector-1.0, das die Dateiübertragungsfunktion bereitstellt. Deshalb müssen Verbundcontroller restConnector-1.0 nicht in einem Feature-Manager angeben, um die REST-APIs anzuzeigen oder Dateiübertragungsoperationen auszuführen. In einer eigenständigen Serverkonfiguration kann das Feature restConnector-1.0 zum Anzeigen der REST-APIs erforderlich sein.

  2. Listen Sie die Zielhosts in einem HTTP-Header für den Verbundcontroller auf.
    com.ibm.websphere.collective.hostNames=durch_Kommas_getrennte_Liste_mit_Zielhosts

    Definieren Sie optional weitere HTTP-Header:

    • Geben Sie an, ob der Dateiupload und die Aktion asynchron durchgeführt werden sollen. Die Standardeinstellung ist false. Zum Ändern der Standardeinstellung geben Sie true für boolean an.
      com.ibm.websphere.jmx.connector.rest.asyncExecution=Boolean
    • Geben Sie eine Gruppe von Aktionen an, die nach dem Dateiupload ausgeführt werden sollen. Eine vorhandene integrierte Aktion ist com.ibm.websphere.jmx.connector.rest.postTransferAction.join, die die Liberty-Server im eingehenden Liberty-Archiv mit dem Verbund verknüpft. Verwenden Sie den Header, um weitere angepasste Aktionen aufzulisten. Wenn Sie mehr als eine angepasste Aktion auflisten, begrenzen Sie die Aktion mit einem URL-codierten Komma.
      com.ibm.websphere.jmx.connector.rest.postTransferAction=durch_Kommas_getrennte_Liste_von_Aktionen
      Zum Aktivieren der angepassten Aktionen fügen Sie der Datei server.xml des Verbundcontrollers die folgende Konfiguration hinzu:
      <hostAccess enableCustomActions="true" />
    • Geben Sie eine Liste mit Optionen an, die an die nach der Übertragung durchzuführenden Aktionen übergeben werden sollen. Die Liste der Optionen muss null sein oder dieselbe Anzahl von Listeneinträgen wie die postTransferAction-Headerliste enthalten, wobei der Eintragsindex jeder Option mit dem Index der entsprechenden Aktion übereinstimmen muss. Wenn Sie mehr als eine Aktion auflisten, begrenzen Sie die Aktion mit einem URL-codierten Komma.
      com.ibm.websphere.jmx.connector.rest.postTransferAction.options=durch_Kommas_getrennte_Liste_von_Aktionen

      Wenn Sie die integrierte Aktion com.ibm.websphere.jmx.connector.rest.postTransferAction.join angeben, muss die entsprechende Option folgendermaßen lauten:

      --user=Administrator --password=Administratorkennwort --keystorePassword=Keystore-Kennwort [--rpcUser=RPC-Benutzer --rpcPassword=RPC-Kennwort]
    • Geben Sie die vor der Ausführung der Übertragungsaktionen auszuführenden Umgebungsvariablen an. Die Nutzdaten des Headers sind ein JSON-Objekt, wobei jeder JSON-Schlüssel eine Umgebungsvariable und jeder JSON-Wert der Wert der Umgebungsvariablen ist. Wenn Sie Systempfade angeben, verwenden Sie Schrägstriche (/).
      com.ibm.websphere.jmx.connector.rest.transferEnvVars=Liste_der_Umgebungsvariablen
  3. Laden Sie mit der Operation POST eine Datei auf mehrere registrierte Hosts hoch.
    1. Stellen Sie sicher, dass sich die Zielposition in einem konfigurierbaren beschreibbaren Verzeichnis auf den Hosts befindet.
    2. Rufen Sie die Operation POST auf.
      POST https://Controller-Host:Controller-Port/IBMJMXConnectorREST/file/{Dateipfad}[?expandOnCompletion=Boolean&local=Boolean]
      • {Dateipfad} steht für einen UTF-8-URL-codierten absoluten Pfad, der die Zielposition angibt. Wenn die Datei beispielsweise den Namen C:/temp/myFile.txt hat, ist der Pfad C%3A%2Ftemp%2FmyFile.txt.
      • expandOnCompletion ist ein optionaler Abfrageparameter, der die automatische Erweiterung des hochgeladenen Archivs aktiviert bzw. inaktiviert. Der Standardwert ist false.
      • local ist ein optionaler Abfrageparameter, der angibt, ob sich die hochzuladende Datei bereits im Controller befindet. Der Standardwert ist false.

Nächste Schritte

Rufen Sie Status- oder Detailinformationen zum REST-Aufruf ab. Informationen hierzu finden Sie unter Status eines REST-Aufrufs für mehrere registrierte Hosts abrufen.


Symbol das den Typ des Artikels anzeigt. Taskartikel

Nutzungsbedingungen für Information Center | Feedback


Symbol für Zeitmarke Letzte Aktualisierung: 25.08.2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_collective_file_transfer_multihost
Dateiname: twlp_collective_file_transfer_multihost.html