在 Linux 上定义 Aspera gateway 连接

IBM® Aspera fasp.io Gateway 提供了快速 TCP/IP 隧道，可以显着提高 IBM MQ的网络吞吐量。在任何授权 CD 平台上运行的队列管理器都可以通过 Aspera gateway进行连接。网关本身部署在 Red Hat® 或 Ubuntu Linux®上。

关于本任务

Aspera gateway 可用于提高队列管理器通道的性能。如果网络具有高延迟或往往丢失包，那么它尤其有效，并且通常用于加快不同数据中心的队列管理器之间的连接。

注: 对于不丢失包的快速网络，使用 Aspera gateway时性能会下降，因此在定义 Aspera gateway 连接之前和之后检查网络性能很重要。

在 IP 网络连接的每一端定义一个 Aspera gateway ，然后使用 TCP/IP 将队列管理器通道连接到每个网关。队列管理器不需要与其使用的 Aspera gateway 在同一机器上运行，并且多个队列管理器可以使用同一网关。唯一的限制如下:

要使用 Aspera gateway，您必须具有以下一项或多项权利:

IBM MQ Advanced for Multiplatforms
IBM MQ Appliance
IBM MQ Advanced for z/OS® VUE

您可以在以下任何 Linux (Red Hat 或 Ubuntu) 平台上部署 Aspera gateway :

Linux for x86-64
Linux on POWER® Systems - Little Endian
Linux for IBM Z

除非网关单独授权，否则 Aspera gateway 的使用仅限于 IBM MQ 消息。

使用 Aspera gateway 的队列管理器可以在 Continuous Delivery (CD) 发行版支持的任何授权平台上运行。有关 CD 平台的完整列表，请参阅产品文档中的发行版和平台图标。

对于与其使用的 Aspera gateway 不在同一机器上的每个队列管理器，请检查队列管理器与 Aspera gateway之间是否具有快速网络连接。

您可以使用 toml 文件来创建用于定义网关所使用的入站和出站端口的网关定义。样本 toml 文件随 Aspera gateway一起提供。出站网关定义定义从本地队列管理器到网关的连接，以及从本地网关到远程网关的连接。入站网关定义定义从远程网关到本地网关的连接，以及从本地网关到本地队列管理器的连接。

以下步骤提供了入门和熟悉运用的基本指南。有关更多详细信息，请参阅 IBM Aspera fasp.io Gateway V1.0.0 文档。

过程

获取 Aspera gateway 安装映像。

如果您的企业具有 IBM MQ Advanced for Multiplatforms 或 IBM MQ Appliance 权利，那么可以从 Passport Advantage下载 Aspera gateway ，作为 IBM MQ V9.1.x Continuous Delivery Release for IBM Aspera fasp.io eAssembly 。要下载此eAssembly, ，请访问下载 IBM MQ 9.1，然后点击最新连续交付版本的选项卡。 eAssembly 包含网关可用的所有 Linux 平台的安装映像。

如果您的企业具有 IBM MQ Advanced for z/OS VUE 权利，那么可以从属于 SMP/E 安装的连接器包组件获取 Aspera gateway 。请参阅 IBM MQ Advanced for z/OS VUE 程序目录 (IBM MQ for z/OS Program Directory PDF 文件) 以获取更多信息。安装连接器包时，它会在 Unix 系统服务中创建一个包含 .zip 文件的 fasp 目录。 .zip 文件包含网关可用的所有 Linux 平台的安装映像。请注意， Aspera gateway 无法在 z/OS上本机运行。
将 Aspera gateway 安装映像复制到将运行网关的两台机器上，然后解压缩并安装网关。
使用 RPM Package Manager (RPM) 进行安装:
```
rpm -ivh ibm-fasp.io-gateway-1.0.0_qa_48-1.x86_64.rpm
```
要在 Ubuntu上使用 RPM 进行安装，您有两个选项:
- 将 --force-debian 属性添加到 Aspera gateway install 命令，如使用 rpm 在 Linux 上安装 IBM MQ 客户机中所述。
- 使用 apt-get 命令:
```
sudo apt-get install ./ibm-fasp.io-gateway_1.0.0_amd64.deb
```
配置每个网关。

修改安装所创建的 /etc/fasp.io 目录中的 gateway.toml 和 logging.toml 文件。使用 gateway.toml 文件来定义网关使用的入站和出站端口，使用 logging.toml 文件来定义所需的日志记录级别。稍后在本主题中提供了编辑 gateway.toml 文件的示例。
在网络连接的每一端，更改通道定义以连接到本地网关正在侦听的端口。
启动每个网关服务。
从命令提示符，运行以下命令:
```
systemctl start fasp.io-gateway
```
重新启动通道。

现在，您的队列管理器正在通过 Aspera gateway 连接进行通信。

示例

此示例定义运行 Linux的两台机器上的 Aspera gateway 连接。该配置如下所示：

本地网关机器的 IP 地址为 9.20.193.107。远程网关机器的 IP 地址为 9.20.192.115。
本地队列管理器正在 IP 地址为 9.20.121.5的机器上运行。远程队列管理器正在 IP 地址为 9.20.121.25的机器上运行。两个队列管理器都在侦听端口 1414。
本地队列管理器上的队列管理器通道已更改为使用 conname 9.20.193.107(1500) 连接到本地 Aspera gateway 。远程队列管理器上的队列管理器通道已更改为使用 conname 9.20.192.115(1500) 连接到远程 Aspera gateway 。

在本地网关机器上定义 Aspera gateway 连接:

安装 Aspera gateway:

rpm -ivh ibm-fasp.io-gateway-1.0.0_qa_48-1.x86_64.rpm

修改安装所创建的 /etc/fasp.io 目录中的 gateway.toml 文件。对其进行编辑以设置本地网关定义。

[[bridge]]
    name = "Outbound"
    [bridge.local]
           protocol = "tcp"
               host = "9.20.193.107"
               port = 1500

    [bridge.forward]
           protocol = "fasp"
               host = "9.20.192.115"
               port = 1600

[[bridge]]
    name = "Inbound"
    [bridge.local]
           protocol = "fasp"
               host = "9.20.193.107"
               port = 1600

    [bridge.forward]
           protocol = "tcp"
               host = "9.20.121.5"
               port = 1414

重复上一步以在远程网关机器上定义 Aspera gateway 连接。修改安装所创建的 /etc/fasp.io 目录中的 gateway.toml 文件。对其进行编辑以设置远程网关定义:

[[bridge]]
    name = "Outbound"
    [bridge.local]
           protocol = "tcp"
               host = "9.20.192.115"
               port = 1500

    [bridge.forward]
           protocol = "fasp"
               host = "9.20.193.107"
               port = 1600

[[bridge]]
    name = "Inbound"
    [bridge.local]
           protocol = "fasp"
               host = "9.20.192.115"
               port = 1600

    [bridge.forward]
           protocol = "tcp"
               host = "9.20.121.25"
               port = 1414

在连接的每一端，更改通道定义以连接到本地网关正在侦听的端口。
- 更改本地队列管理器上的队列管理器通道，以使用 conname 9.20.193.107(1500) 连接到本地 Aspera gateway 。
- 更改远程队列管理器上的队列管理器通道，以使用 conname 9.20.192.115(1500) 连接到远程 Aspera gateway 。
通过在本地网关机器上运行以下命令来启动本地网关:
```
systemctl start fasp.io-gateway
```
通过在远程网关机器上运行以下命令来启动远程网关:
```
systemctl start fasp.io-gateway
```
重新启动通道。

后续操作

Aspera gateway 会传递其接收的数据，而不会以任何方式对其进行解释。这意味着您可以在使用 Aspera gateway的队列管理器通道之间配置 TLS ，因为网关连接不知道 TLS 握手。这也意味着任何受支持的 IBM MQ 平台上的队列管理器都可以使用 Aspera gateway。

要将多实例队列管理器与网关配合使用，请为队列管理器的每个实例配置网关定义。

注: Aspera gateway 仅使用队列管理器通道进行了测试。尚未使用客户机通道进行测试。这是因为 Aspera gateway 的预期用途是通过慢速网络连接远程队列管理器，而客户机应用程序通常通过快速网络连接到本地数据中心内的队列管理器。