Carga de archivos en varios hosts registrados con una sola llamada REST

Puede cargar archivos desde un controlador de colectivo a varios hosts registrados de un colectivo invocando la API REST POST. Las operaciones de transferencia de archivos se producen en IBM JMX REST Connector.

Antes de empezar

Cree un controlador de colectivo. Consulte Configuración de un colectivo de Liberty.

Registre cada equipo host remoto con el controlador de colectivo. Consulte Registro de sistemas principales con un colectivo de Liberty.

Procedimiento

  1. Opcional: Para obtener información sobre las API REST, consulte con navegador https://nombre_host_controlador:nombre_puerto_controlador/IBMJMXConnectorREST/api y especifique el ID de usuario y la contraseña de inicio de sesión del administrador del controlador. El controlador debe estar en ejecución para ver la documentación de la API REST.

    En las secciones Transferencia de archivos y Direccionamiento se describen las API utilizadas para transferir archivos entre el controlador de colectivo y un servidor miembro o un host registrado.

    La característica collectiveController-1.0 habilita la característica restConnector-1.0 que proporciona la prestación de transferencia de archivos. Por lo tanto, los controladores de colectivos no necesitan especificar restConnector-1.0 en un gestor de características para ver las API REST o realizar operaciones de transferencia de archivos. Una configuración de servidor autónomo puede necesitar la característica restConnector-1.0 para ver las API REST.

  2. Lista de los hosts de destino en una cabecera HTTP para el controlador de colectivo.
    com.ibm.websphere.collective.hostNames=lista_separada_por_comas_de_hosts_de_destino

    Opcionalmente, establezca otras cabeceras HTTP:

    • Especifique si se van a llevar a cabo las cargas de archivos y la acción de forma asíncrona. El valor predeterminado es false. Para cambiar el valor predeterminado, especifique true para booleano.
      com.ibm.websphere.jmx.connector.rest.asyncExecution=booleano
    • Especifique un conjunto de acciones que se llevarán a cabo después de las cargas de archivos. Una acción incorporada existente es com.ibm.websphere.jmx.connector.rest.postTransferAction.join, que une los servidores de Liberty incluidos en el archivo de archivado de entrada de Liberty con el colectivo. Utilice la cabecera para listar otras acciones personalizadas. Si se lista más de una acción personalizada, delimite la acción con un carácter de coma codificado en URL.
      com.ibm.websphere.jmx.connector.rest.postTransferAction=lista_de_acciones_separada_por_comas
      Para habilitar las acciones personalizadas, añada la siguiente configuración al controlador de colectivo server.xml:
      <hostAccess enableCustomActions="true" />
    • Especifique una lista de opciones para pasar a las acciones posteriores a la transferencia. Esta lista de opciones debe ser un valor nulo o contener la misma cantidad de elementos de lista que la lista de cabecera postTransferAction, en que el índice de elementos de cada opción debe coincidir con el índice de la acción correspondiente. Si se lista más de una opción, delimite la acción con un carácter de coma codificado en URL.
      com.ibm.websphere.jmx.connector.rest.postTransferAction.options=lista_de_opciones_separada_por_comas

      Si especifica la acción incorporada com.ibm.websphere.jmx.connector.rest.postTransferAction.join, la opción correspondiente debe ser:

      --user=adminUser --password=adminPw --keystorePassword=keystorePw [--rpcUser=rpcUser --rpcPassword=rpcPw]
    • Especifique las variables de entorno que se deben establecer antes de ejecutar las acciones de transferencia. La carga útil de la cabecera es un objeto JSON, donde cada clave JSON es una variable de entorno y cada valor JSON es el valor correspondiente. Si especifica vías de acceso del sistema, utilice barras inclinadas (/).
      com.ibm.websphere.jmx.connector.rest.transferEnvVars=list_of_environment_variables
  3. Cargue un archivo en varios hosts registrados utilizando la operación POST.
    1. Asegúrese de que la ubicación de destino se halle dentro de un directorio de escritura configurable de los hosts.
    2. Invoque la operación POST.
      POST https://host_controlador:puertos_controlador/IBMJMXConnectorREST/file/{via_acceso_archivo}[?expandOnCompletion=booleano&local=booleano]
      • {vía_acceso_archivo} es una vía de acceso absoluta codificada en URL de UTF-8 que especifica la ubicación de destino. Por ejemplo, si este archivo es C:/temp/myFile.txt, la vía de acceso es C%3A%2Ftemp%2FmyFile.txt.
      • expandOnCompletion es un parámetro de consulta opcional que conmuta a una expansión automática del archivador cargado. El valor predeterminado es false.
      • local es un parámetro de consulta opcional que especifica si el archivo que se debe cargar ya está en el controlador. Si es true, la carga útil de esta solicitud POST es una serie que representa la ubicación del archivo de origen dentro del controlador. El valor predeterminado es false.
      • Si el parámetro de consulta local no se utiliza, o se establece explícitamente en false, la carga útil de POST es el contenido binario del propio archivo de origen.

Qué hacer a continuación

Obtención del estado o de los detalles en la llamada REST. Consulte Obtención del estado en una llamada REST para varios hosts registrados.


Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_collective_file_transfer_multihost.html