Mit REST-Aufrufen Dateien an Verbundmember oder registrierte Hosts übertragen und von diesen empfangen

Sie können gesteuerte Dateiübertragungsoperationen von einem Verbundcontroller an ein Verbundmember oder an einen registrierten Host eines Verbunds durch den Aufruf von REST-APIs ausführen. Zu den Operationen gehören das Herunterladen von Dateien von einer fernen Position, das Hochladen von Dateien an eine ferne Position und das Löschen von Dateien an einer fernen Position. Verwenden Sie dazu die REST-APIs GET, POST und DELETE. Die Dateiübertragungsoperationen finden innerhalb eines IBM JMX-REST-Connectors statt.

Vorbereitende Schritte

Zum Durchführen von Dateiübertragungsoperationen von einem Verbundcontroller an einen Member-Server muss der Server als Member mit dem Verbund verknüpft sein. Informationen hierzu finden Sie unter Liberty-Verbund konfigurieren.

Zum Durchführen von Dateiübertragungsoperationen an einen Host-Computer muss der Host beim Verbundcontroller registriert sein. Informationen hierzu finden Sie unter Host-Computer werden bei einem Liberty-Verbund registriert.

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. Alternativ können Sie zum Anzeigen der Dokumentation zu den REST-APIs den Host, Port, die Anmeldebenutzer-ID und das Kennwort eines Verbundmembers verwenden.

    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.

    Die Features collectiveController-1.0 und collectiveMember-1.0 aktivieren das Feature restConnector-1.0, das die Dateiübertragungsfunktion bereitstellt. Deshalb müssen Verbundcontroller und -Member 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. Sofern Sie nicht direkt mit einer Liberty-Instanz arbeiten, definieren Sie den Routing-Kontext in Form von HTTP-Headern.
    • Routing von Member-Servern
      com.ibm.websphere.jmx.connector.rest.routing.hostName=Zeichenfolge
      com.ibm.websphere.jmx.connector.rest.routing.serverName=Zeichenfolge
      com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=Zeichenfolge
    • Routing registrierter Hosts
      com.ibm.websphere.jmx.connector.rest.routing.hostName=Zeichenfolge
  3. Stellen Sie sicher, dass sich die Zieldatei in den konfigurierbaren lesbaren/beschreibbaren Verzeichnissen des Servers für Dateiübertragungsoperationen mit einem Member-Server oder in konfigurierbaren lesbaren/beschreibbaren Verzeichnissen des Hosts für Dateiübertragungsoperationen mit einem registrierten Hosts befindet.
  4. Rufen Sie die REST-API auf, die Dateien herunterlädt, hochlädt oder löscht.

    Der {Dateipfad} muss URL-codiert sein. Für Routing-Operationen mit registrierten Hosts muss der {Dateipfad} ein absoluter Pfad sein, der keine Liberty-Variablen enthalten darf.

    • Laden Sie mit der Operation GET eine Datei von einem Member-Server oder registrierten Host herunter.
      GET https://Controller-Host:Controller-Port/IBMJMXConnectorREST/file/{Dateipfad}
    • Laden Sie mit der Operation POST eine Datei auf einen Member-Server oder einen registrierten Host hoch.
      POST https://Controller-Host:Controller-Port/IBMJMXConnectorREST/file/{Dateipfad}
    • Löschen Sie mit der Operation DELETE eine Datei von einem Member-Server oder registrierten Host.
      DELETE https://Controller-Host:Controller-Port/IBMJMXConnectorREST/file/{Dateipfad}
    • Löschen Sie mit der Operation POST mehrere Dateien von einem Member-Server oder registrierten Host.
      POST https://Controller-Host:Controller-Port/IBMJMXConnectorREST/file/collection

Beispiel

Gehen Sie zum Herunterladen der Datei myFile.txt vom Member-Server myServerA auf den Host myTarget.com mit dem Benutzerverzeichnis C:/server/wlp folgendermaßen vor:
  1. Legen Sie den Routing-Kontext des Member-Servers mit HTTP-Headern fest:
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
    com.ibm.websphere.jmx.connector.rest.routing.serverName=myServerA
    com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=C:/server/wlp
  2. Setzen Sie einen GET-Aufruf zum Herunterladen der Datei ab:
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
Gehen Sie zum Herunterladen der Datei myFile.txt vom registrierten Host myTarget.com wie folgt vor:
  1. Legen Sie den Routing-Kontext des registrierten Hosts mit einem HTTP-Header fest:
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
  2. Setzen Sie einen GET-Aufruf zum Herunterladen der Datei ab:
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
Gehen Sie zum Herunterladen der Datei server.xml vom Member-Server myServerA auf den Host myTarget.com mit dem Benutzerverzeichnis C:/server/wlp folgendermaßen vor:
  1. Legen Sie den Routing-Kontext des Member-Servers mit HTTP-Headern fest:
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
    com.ibm.websphere.jmx.connector.rest.routing.serverName=myServerA
    com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=C:/server/wlp
  2. Setzen Sie einen GET-Aufruf zum Herunterladen der Datei ${server.config.dir}/server.xml ab:
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/%24{server.config.dir}%2Fserver.xml

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

Dateiname: twlp_collective_file_transfer_member_host.html