[8.5.5.6 ou ultérieure]

Transfert de fichiers vers et depuis un membre de collectivité ou un hôte enregistré avec des appels REST

Vous pouvez réaliser des opérations de transfert de fichiers de routage d'un contrôleur de collectivité à un membre de collectivité ou à un hôte enregistré d'une collectivité en appelant les API REST. Les opérations incluent le téléchargement de fichiers depuis un emplacement distant, le téléchargement de fichiers vers un emplacement distant et la suppression de fichiers dans un emplacement distant. Utilisez les API REST GET, POST ou DELETE. Les opérations de transfert de fichier ont lieu dans un connecteur REST IBM JMX.

Avant de commencer

Pour réaliser des opérations de transfert de fichiers d'un contrôleur de collectivité à un serveur membre, le serveur doit être joint en tant que membre dans la collectivité. Voir Configuration d'une collectivité Liberty.

Pour réaliser des opérations de transfert de fichiers vers un ordinateur hôte, l'hôte doit être enregistré avec le contrôleur de collectivité. Voir Enregistrement des ordinateurs hôte auprès d'une collectivité Liberty.

Procédure

  1. Facultatif : Pour en savoir plus sur les API REST, tapez https://nom_hôte_contrôleur:nom_port_contrôleur/IBMJMXConnectorREST/api dans votre navigateur et entrez l'ID et le mot de passe de l'administrateur du contrôleur pour vous connecter. Le contrôleur doit être exécuté pour pouvoir afficher la documentation de l'API REST. Vous pouvez également utiliser l'hôte, le port, l'ID de connexion et le mot de passe d'un membre de collectivité pour afficher la documentation de l'API REST.

    Les sections Transfert de fichier et Routage décrivent les API utilisées pour transférer des fichiers entre le contrôleur de collectivité et un serveur membre ou un hôte enregistré.

    Les fonctions collectiveController-1.0 et collectiveMember-1.0 activent la fonction restConnector-1.0, qui permet de transférer des fichiers. Ainsi, les contrôleurs et les membres de collectivité n'ont pas besoin de spécifier restConnector-1.0 dans un gestionnaire de fonctions pour afficher les API REST ou pour effectuer des opérations de transfert de fichiers. Une configuration de serveur autonome peut nécessiter la fonction restConnector-1.0 pour afficher les API REST.

  2. A moins de travailler directement avec un instance Liberty, définissez le contexte de routage comme en-têtes HTTP.
    • Routage du serveur membre
      com.ibm.websphere.jmx.connector.rest.routing.hostName=string
      com.ibm.websphere.jmx.connector.rest.routing.serverName=string
      com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=string
    • Routage de l'hôte enregistré
      com.ibm.websphere.jmx.connector.rest.routing.hostName=string
  3. Vérifiez que le fichier cible se trouve parmi les répertoires de lecture/écriture configurables du serveur (pour les opérations de transfert de fichiers avec un serveur membre), ou parmi les répertoires de lecture/écriture configurables de l'hôte (pour les opérations de transfert de fichiers avec un hôte enregistré).
  4. Appelez les API REST qui permettent de supprimer les fichiers et de les envoyer ou de les recevoir par téléchargement.

    Le {cheminFichier} doit être encodé dans une URL. Pour les opérations de routage avec des hôtes enregistrés, {cheminFichier} doit être un chemin absolu et ne peut pas contenir de variables Liberty.

    • Téléchargez un fichier d'un serveur membre ou d'un hôte enregistré à l'aide de l'opération GET.
      GET https://hôte_contrôleur:port_contrôleur/IBMJMXConnectorREST/file/{cheminFichier}
    • Téléchargez un fichier vers un serveur membre ou un hôte enregistré à l'aide de l'opération POST.
      POST https://hôte_contrôleur:port_contrôleur/IBMJMXConnectorREST/file/{cheminFichier}
    • Supprimez un fichier d'un serveur membre ou d'un hôte enregistré à l'aide de l'opération DELETE.
      DELETE https://hôte_contrôleur:port_contrôleur/IBMJMXConnectorREST/file/{cheminFichier}
    • Supprimez plusieurs fichiers d'un serveur membre ou d'un hôte enregistré à l'aide de l'opération POST.
      POST https://hôte_contrôleur:port_contrôleur/IBMJMXConnectorREST/file/collection

Exemple

Pour télécharger le fichier myFile.txt du serveur membre myServerA sur l'hôte myTarget.com avec un répertoire utilisateur C:/server/wlp :
  1. Définissez le contexte de routage du serveur membre comme en-têtes HTTP.
    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. Appelez un appel GET pour recevoir le fichier par téléchargement.
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
Pour recevoir le fichier myFile.txt par téléchargement de l'hôte enregistré myTarget.com :
  1. Définissez le contexte de routage de l'hôte enregistré comme en-tête HTTP.
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
  2. Appelez un appel GET pour recevoir le fichier par téléchargement.
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
Pour télécharger le fichier server.xml du serveur membre myServerA sur l'hôte myTarget.com avec un répertoire utilisateur C:/server/wlp :
  1. Définissez le contexte de routage du serveur membre comme en-têtes HTTP.
    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. Appelez un appel GET pour recevoir le fichier ${server.config.dir}/server.xml par téléchargement.
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/%24{server.config.dir}%2Fserver.xml

Que faire ensuite

Obtenez l'état ou les détails de l'appel REST. Voir Obtention de l'état sur un appel REST pour plusieurs hôtes enregistrés.


Icône indiquant le type de rubrique Rubrique Tâche

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_collective_file_transfer_member_host
Nom du fichier : twlp_collective_file_transfer_member_host.html