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.
Weitere 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 bei einem Liberty-Verbund registrieren.
Vorgehensweise
- 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 Controlleradministrators 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 Host
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.
- 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
- 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.
- 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:
- 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
- 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:
- Legen Sie den Routing-Kontext des registrierten Hosts mit einem HTTP-Header fest:
com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
- 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:
- 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
- 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.