Return to Aspera faspio labs page
In this laboratory, you will explore the benefits of employing the IBM Aspera faspio Gateway alongside IBM MQ Queue Managers that are situated in two remote regions.
What is Aspera faspio Gateway?
IBM Aspera faspio Gateway is a software component that accelerates TCP-based data transfers between systems, leveraging the Aspera FASP protocol for high-speed, reliable, and secure data movement over any distance. It acts as a bridge, enhancing data transfer performance, particularly over networks with high latency or packet loss.
Architecture Diagram

The IBM MQ Queue Managers between AMERICAS, and EUROPE are linked via a set of Sender/Receiver TCP channels.
Then, we will leverage IBM Aspera faspio bridge between the MQ Sender/Receiver Channels to speed up message transfers between the two Queue Managers.
Environment
You will make use of two IBM Techzone environments situated in the AMERICAS and EUROPE regions.
Testing
You will be testing two usecases.
a) Send 1000 messages of 1MB size over TCP Channel
b) Send 1000 messages of 1MB size over FASP Channel
Then, compare the results TCP vs FASP.
Capture IP address of AMERICAS and EUROPE environments.

Save the IP Address(s) to a Notepad. You will need these to setup faspio gateway on both the regions.
In this step, you will setup Aspera faspio Gateway on both the regions.
From the Google Chrome browser, open AMERICAS environment URL.
Open Windows Virtual Machine.

Open 3 Putty Program, then open aspera3 Virtual Machine.

Arrange the 3-Putty Windows side by side.
Login Credentials: ibmuser/engageibm
On the 1st Putty Window, run the following commands.
NOTE: SKIP to the next section if you have completed lab1.
cd ~/faspio
sudo ./setup-faspio.sh <EUROPE-SERVER-IP-ADDRESS>
This step will create aspera-license, and gateway.toml files into /etc/faspio-gateway directory.
Note: Aspera faspio Gateway license is required. Aspera faspio Gateway is part of IBM MQ Advanced entitlement.
Setup faspio Gateway
sudo systemctl enable faspio-gateway
sudo systemctl start faspio-gateway
sudo systemctl status faspio-gateway
Note: Please make sure there aren’t any errors and faspio is started successfully.
From the Windows VM, open a Google Chrome browser, then open EUROPE environment URL.
Open 3 Putty Program, then open aspera3 Virtual Machine.

Arrange the 3-Putty Windows side by side.
Login Credentials: ibmuser/engageibm
One the first Putty Window, run the following commands.
NOTE: SKIP to the next section if you have completed lab1.
cd ~/faspio
sudo ./setup-faspio.sh <AMERICAS-SERVER-IP-ADDRESS>
This step will create aspera-license, and gateway.toml files into /etc/faspio-gateway directory.
Setup faspio Gateway
sudo systemctl enable faspio-gateway
sudo systemctl start faspio-gateway
sudo systemctl status faspio-gateway
Note: Please make sure there aren’t any errors and faspio is started successfully.
In this step, you will setup IBM MQ Queue Mansgers on both the regions.
You are tasked with establishing a Queue Manager named QMWDCD01 (where WDC denotes Washington DC).
cd ~/faspio
./setup-americas-europe-qmgr.sh <EUROPE-SERVER-IP-ADDRESS>
Review the results.
Note: Due to the time limitations of the workshop, we streamlined the lab process and developed scripts for establishing the MQ Queue Managers and their connectivity. Kindly review the scripts if time allows.
You are tasked with establishing a Queue Manager named QMLDND01 (where LDN denotes London).
cd ~/faspio
./setup-europe-americas-qmgr.sh <AMERICAS-SERVER-IP-ADDRESS>
Review the results.
Now, lets verify the MQ Channels are in RUNNING state.
echo "dis chstatus(wdc.ldn.*)" | runmqsc QMWDCD01

It is now the moment to evaluate our efforts.
Copy and paste the below commands in each of the Putty Windows.
Putty Window3
watch -n 1 'echo "dis qlocal(xmitq.QMLDND01.FASP) curdepth" | runmqsc QMWDCD01'
Putty Window2
watch -n 1 'echo "dis qlocal(XMITQ.QMLDND01.TCP) curdepth" | runmqsc QMWDCD01'
Putty Window1
Lets blast 1000 messages of each message size of 1MB into the TCP and FASP Remote Queues.
amqsblst QMWDCD01 QR.LDN.TCP.IN -W -s 1048576 -c 1000 && amqsblst QMWDCD01 QR.LDN.FASP.IN -W -s 1048576 -c 1000
The MQ blast messages program dumps 1000 messages into both TCP and FASP transmission Queues at almost the same time.
********************
**OBSERVE the Speed TCP vs FASP
********************

Notice that FASP Transmission Queue is being drained quicker than TCP Transmission Queue.
Copy and paste the below commands in each of the Putty Windows.
Putty Window3
watch -n 1 'echo "dis qlocal(fasp.in) curdepth" | runmqsc QMLDND01'
Putty Window2
watch -n 1 'echo "dis qlocal(tcp.in) curdepth" | runmqsc QMLDND01'
if, the transfer is successful you should see 1000 messages in TCP.IN, and FASP.IN queues.

Note that the TCP transfer is still going in the top window in the screenshot above.
You explored the functionalities of the IBM Aspera faspio Gateway by connecting IBM MQ Channels, which led to an improvement in transfer speeds of 60-70%. Furthermore, you have the ability to modify the Channel BATCHSZ attribute to enhance performance even more.
The distance significantly impairs TCP performance, and this is where FASP excels. Below is an illustration of the same tests conducted between the AMERICAS and ASIAPACIFIC Regions.

As observed, the FASP transmission queue is nearly depleted, whereas the TCP transmission queue is exceedingly sluggish. It is evident that there is a significant disparity in the transfer rates between TCP and FASP across remote areas and slow networks.