在 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 檔案來建立閘道定義，以定義閘道使用的入埠及出埠埠。 Aspera gateway隨附範例 toml 檔。出埠閘道定義會定義從本端佇列管理程式到閘道的連線，以及從本端閘道到遠端閘道的連線。入埠閘道定義定義從遠端閘道到本端閘道的連線，以及從本端閘道到本端佇列管理程式的連線。

下列步驟提供入門及執行的基本手冊。如需詳細資訊，請參閱 IBM Aspera fasp.io Gateway 說明文件。

程序

取得 Aspera gateway 安裝映像檔。

[UNIX、Linux、Windows、IBM i] 若為 Multiplatforms ，您可以從 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 程式目錄 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 的檔名
平台	Long Term Support		Continuous Delivery
平台	檔名	fasp.io 版本號碼	檔名	fasp.io 版本號碼
Linux for x86-64	CC6UIEN.zip	1.1.0	CC6UIEN.zip CC8R1EN.zip G01WVEN.zip	1.1.0 1.1.1 1.2.0
Linux on POWER Systems - Little Endian	CC6UKEN.zip	1.1.0	CC6UKEN.zip CC8R2EN.zip G01WWEN.zip	1.1.0 1.1.1 1.2.0
Linux for IBM Z	CC6ULEN.zip	1.1.0	CC6ULEN.zip CC8R3EN.zip G01WXEN.zip	1.1.0 1.1.1 1.2.0
Windows	CC6UMEN.zip	1.1.0	CC6UMEN.zip CC8R4EN.zip G01WYEN.zip	1.1.0 1.1.1 1.2.0

[持續交付] [MQ 9.2.0 2020 年 7 月] 請注意， Aspera gateway 無法原生在 z/OS上執行。

附註:

IBM MQ 9.2.0上的 fasp.io 1.1.1 版由 APAR PH35485 提供。
IBM MQ 9.2.0上的 fasp.io 1.2.0 版由 APAR PH38832 提供。

將 Aspera gateway 安裝映像檔複製到將執行閘道的兩部機器上，然後解壓縮並安裝閘道。
使用 RPM Package Manager (RPM) 安裝:
```
rpm -ivh ibm-fasp.io-gateway-<version>.x86_64.rpm
```
若要在 Ubuntu上使用 RPM 安裝，您有兩個選項:
- 將 --force-debian 屬性新增至 Aspera gateway 安裝指令，如使用 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 」的預期用途是透過慢速網路連接遠端佇列管理程式，而用戶端應用程式通常透過快速網路連接至本端資料中心內的佇列管理程式。