使用单个 REST 调用将文件上载至多个已注册主机

通过调用 POST REST API,可将集合体控制器中的文件上载至集合体的多个已注册主机。文件传输操作在 IBM JMX REST 连接器中进行。

开始之前

创建集合体控制器。请参阅配置 Liberty 集合体

向集合体控制器注册每个远程主机。请参阅向 Liberty 集合体注册主机

过程

  1. 可选: 要阅读有关 REST API 的信息,请使用浏览器访问 https://controller_host_name:controller_port_name/IBMJMXConnectorREST/api 并输入控制器管理用户标识和密码以登录。控制器必须正在运行才能查看 REST API 文档。

    文件传输路由部分描述用于在集合体控制器与成员服务器或已注册主机间传输文件的 API。

    collectiveController-1.0 功能部件启用 restConnector-1.0 功能部件,后者提供文件传输功能。因此,集合体控制器不必在功能部件管理器中指定 restConnector-1.0 来查看 REST API 或执行文件传输操作。独立服务器配置可能需要 restConnector-1.0 功能部件来查看 REST API。

  2. 在 HTTP 头中列示集合体控制器的目标主机。
    com.ibm.websphere.collective.hostNames=comma-separated_list_of_target_hosts

    (可选)设置其他 HTTP 头:

    • 指定是否以异步方式执行文件上载和该操作。缺省值为 false。要更改缺省值,请对 boolean 指定 true
      com.ibm.websphere.jmx.connector.rest.asyncExecution=boolean
    • 指定要在文件上载后执行的一组操作。现有内置操作为 com.ibm.websphere.jmx.connector.rest.postTransferAction.join,此操作会使入局 Liberty 归档中的 Liberty 服务器加入集合体。使用头列示其他定制操作。如果列示多个定制操作,请使用 URL 编码逗号字符来对操作定界。
      com.ibm.websphere.jmx.connector.rest.postTransferAction=comma-separated_list_of_actions
      要启用定制操作,请将以下配置添加至集合体控制器 server.xml
      <hostAccess enableCustomActions="true" />
    • 指定要传递至传输后操作的选项列表。此选项列表必须为空,或者其包含的列表项数必须与 postTransferAction 头列表中包含的项数相同,其中每个选项的项下标必须与其对应操作的下标匹配。如果列示多个选项,请使用 URL 编码逗号字符来对操作定界。
      com.ibm.websphere.jmx.connector.rest.postTransferAction.options=comma-separated_list_of_options

      如果指定内置操作 com.ibm.websphere.jmx.connector.rest.postTransferAction.join,那么对应选项必须为:

      --user=adminUser --password=adminPw --keystorePassword=keystorePw [--rpcUser=rpcUser --rpcPassword=rpcPw]
    • 指定传输操作运行前要设置的环境变量。头的有效内容为 JSON 对象,其中每个 JSON 键是一个环境变量,每个 JSON 值是其对应值。如果指定系统路径,请使用正斜杠 (/)。
      com.ibm.websphere.jmx.connector.rest.transferEnvVars=list_of_environment_variables
  3. 使用 POST 操作将文件上载至多个已注册主机。
    1. 确保目标位置在主机的可配置写目录内。
    2. 调用 POST 操作。
      POST https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}[?expandOnCompletion=boolean&local=boolean]
      • {filePath} 是 UTF-8 URL 编码绝对路径,此路径用于指定目标位置。例如,如果文件为 C:/temp/myFile.txt,那么路径为 C%3A%2Ftemp%2FmyFile.txt
      • expandOnCompletion 是一个可选查询参数,它用于开启/关闭所上载归档的自动扩展。缺省值是 false
      • local 是一个可选查询参数,用于指定要上载的文件是否已在控制器中。如果为 True,那么此 POST 请求的有效内容为表示控制器中源文件位置的字符串。缺省值是 false
      • 如果 local 查询参数未使用,或显式设置为 False,那么 POST 有效内容为源文件本身的二进制内容。

下一步做什么

获取 REST 调用的状态或详细信息。请参阅获取针对多个已注册主机的 REST 调用的状态


用于指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: Monday, 5 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=twlp_collective_file_transfer_multihost
文件名:twlp_collective_file_transfer_multihost.html