在 Linux 或 Windows 上定义 Aspera gateway 连接

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

关于本任务

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
IBM MQ Advanced for z/OS (仅限Long Term Support )

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

Linux for x86-64
Linux on POWER® Systems - Little Endian
Linux for IBM Z
Windows -有关 Windows上的平台支持的更多信息，请参阅 IBM Aspera fasp.io Gateway 文档。

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

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

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

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

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

过程

获取 Aspera gateway 安装映像。

[UNIX、Linux、Windows、IBM i] 对于多平台，从 Passport Advantage下载 Aspera gateway 。下载标记为 IBM Aspera fasp.io Continuous Delivery Release for IBM MQ V9.2.x Multiplatform Multilingual eAssembly。仅由于此区域的更改速度，才会将其作为 Continuous Delivery (CD) 映像交付，这意味着需要按 CD 发行版的频率进行更新，并且您可以将其安装在具有 IBM MQ Advanced for Multiplatforms 或 IBM MQ Appliance 权利的任何 IBM MQ 系统上。要下载此eAssembly, ，请访问下载 IBM MQ 9.2，然后点击最新版本的选项卡。 eAssembly 包含网关可用的所有平台的安装映像。

[IBM MQ Advanced VUE] [IBM MQ Advanced for z/OS] 如果 IBM MQ 系统具有 IBM MQ Advanced for z/OS VUE 权利或 Long Term Support IBM MQ Advanced for z/OS 权利，那么您将从属于 SMP/E 安装的连接器包组件获取 Aspera gateway 。有关更多信息，请参阅 IBM MQ Advanced for z/OS VUE 或 IBM MQ Advanced for z/OS 程序目录 (IBM MQ for z/OS Program Directory PDF 文件)。安装连接器包时，它会在 z/OS UNIX System Services 中创建包含一组压缩文件的 fasp 目录。这些文件包含网关可用的所有平台的安装映像。

IBM MQ Advanced for z/OS VUE 和 IBM MQ Advanced for z/OS 的文件如下所示:

表 1. Long Term Support 和 Continuous Delivery 的文件名
平台	文件名	fasp.io 版本号
Linux for x86-64	CC6UIEN.zip	1.1.0
	CC8R1EN.zip	1.1.1 ^1.b
	G01WVEN.zip	1.2.0 ^1.c
	M0LDNEN.zip	1.3.5 ^1.d
Linux on POWER Systems - Little Endian	CC6UKEN.zip	1.1.0
	CC8R2EN.zip	1.1.1 ^1.b
	G01WWEN.zip	1.2.0 ^1.c
	M0LDPEN.zip	1.3.5 ^1.d
Linux for IBM Z	CC6ULEN.zip	1.1.0
	CC8R3EN.zip	1.1.1 ^1.b
	G01WXEN.zip	1.2.0 ^1.c
	M0LDQEN.zip	1.3.5 ^1.d
Windows	CC6UMEN.zip	1.1.0
	CC8R4EN.zip	1.1.1 ^1.b
	G01WYEN.zip	1.2.0 ^1.c
	M0LDREN.zip	1.3.5 ^1.d

备注信息：

Aspera gateway 无法在上本地运行。 z/OS
fasp.io 版本由 APAR 在上提供。 1.1.1 PH35485 IBM MQ 9.2.0
fasp.io 版本由 APAR 在上提供。 1.2.0 PH38832 IBM MQ 9.2.0
fasp.io 版本由 APAR 在上提供。 1.3.5 PH63366 IBM MQ 9.2.0

将 Aspera gateway 安装映像复制到将运行网关的两台机器上，然后解压缩并安装网关。
使用 RPM Package Manager (RPM) 进行安装:
```
rpm -ivh ibm-fasp.io-gateway-<version>.x86_64.rpm
```
要在 Ubuntu上使用 RPM 进行安装，您有两个选项:
- 将 --force-debian 属性添加到 Aspera gateway install 命令，如使用 rpm 在 Linux 上安装 IBM MQ 客户机中所述。
- 使用 apt-get 命令:
```
sudo apt-get install ./ibm-fasp.io-gateway_<version>_amd64.deb
```
要在 Windows上安装 Aspera gateway :
1. 确保您位于受支持的 Windows 机器上，并且使用具有管理员特权的帐户登录。
2. 下载安装程序。缺省位置为 Downloads 文件夹: ibm-fasp.io-gateway_<version>_win64.msi。
3. 打开 .msi 文件。安装向导启动时，请遵循提示完成安装。
配置每个网关。

修改安装所创建的目录中的 gateway.toml 和 logging.toml 文件:

Linux

从 IBM Aspera fasp.io Gateway 1.2 ，位置是 /usr/local/etc/faspio/ 。

从 IBM Aspera fasp.io Gateway 1.1 ，位置是 /usr/local/etc/fasp.io/ 。

对于较早版本的 Aspera gateway，位置为 /etc/fasp.io/。

Windows

C:\Program Files\IBM\fasp.io Gateway\config\

使用 gateway.toml 文件来定义网关使用的入站和出站端口，使用 logging.toml 文件来定义所需的日志记录级别。稍后在本主题中提供了编辑 gateway.toml 文件的示例。
在网络连接的每一端，更改通道定义以连接到本地网关正在侦听的端口。
启动每个网关服务。
从命令提示符，运行以下命令:
- ```
systemctl start fasp.io-gateway
```
- ```
net 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 。
IBM Aspera fasp.io Gateway 1.2 默认启用TLS。在此示例中，已通过在网关定义中设置 tls_enabled=false 来禁用 TLS。如果与较低版本的网关一起运行，请删除 tls_enabled=false 行。如果要使用网关配置 TLS ，请参阅 IBM Aspera fasp.io Gateway 文档中的保护网关。

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

安装 Aspera gateway:
- 在 Linux 上，使用以下命令：
```
rpm -ivh ibm-fasp.io-gateway-<version>.x86_64.rpm
```
- 在 Windows 上，打开 .msi 文件，运行安装向导。

修改安装所创建的目录中的 gateway.toml 文件:

Linux: 从 IBM Aspera fasp.io Gateway 1.2 ，位置是 /usr/local/etc/faspio/ 。; 从 IBM Aspera fasp.io Gateway 1.1 发送，目录为 /usr/local/etc/fasp.io/ 。; 对于较早版本的 Aspera gateway，目录为 /etc/fasp.io/。
Windows: C:\Program Files\IBM\fasp.io Gateway\config\

编辑文件以设置本地网关定义。

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

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

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

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

重复上一步以在远程网关机器上定义 Aspera gateway 连接。修改安装所创建的目录中的 gateway.toml 文件:

Linux: 从 IBM Aspera fasp.io Gateway 1.1 发送，目录为 /usr/local/etc/fasp.io/ 。; 对于较早版本的 Aspera gateway，目录为 /etc/fasp.io/。
Windows: C:\Program Files\IBM\fasp.io Gateway\config\

编辑文件以设置远程网关定义:

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

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

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

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

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

后续操作

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

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

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