Technical Blog Post
Abstract
How to set up and test FASP with Connect:Direct for UNIX.
Body
How to set up and test FASP with Connect:Direct for UNIX
The testing performed in this environment is using a simple Loopback script transferring a file greater than 1GB, which is determined by the bandwidth specified in the license. The FASP configuration shown below reflects the minimum parameters needed to enable FASP.
For more details refer to the FASP document links located at the bottom of this document.
netmap.cfg configuration file
local.node:\
:api.max.connects=16:\
:conn.retry.stwait=00.00.30:\
:conn.retry.stattempts=3:\
:conn.retry.ltwait=00.10.00:\
:conn.retry.ltattempts=6:\
:tcp.max.time.to.wait=180:\
:runstep.max.time.to.wait=0:\
:contact.name=:\
:contact.phone=:\
:descrip=:\
:sess.total=255:\
:sess.pnode.max=255:\
:sess.snode.max=255:\
:sess.default=1:\
:tcp.api=ironman;4263:\
:tcp.api.bufsize=32768:\
:comm.bufsize=65536:\
:pacing.send.delay=0:\
:pacing.send.count=0:\
:netmap.check=n:\
:proxy.attempt=n:\
:fasp=yes:
ironman42:\
:conn.retry.stwait=00.00.30:\
:conn.retry.stattempts=3:\
:conn.retry.ltwait=00.10.00:\
:conn.retry.ltattempts=6:\
:tcp.max.time.to.wait=180:\
:runstep.max.time.to.wait=0:\
:contact.name=:\
:contact.phone=:\
:descrip=:\
:sess.total=255:\
:sess.pnode.max=255:\
:sess.snode.max=255:\
:sess.default=1:\
:comm.info=ironman;4264:\
:comm.transport=tcp:\
:comm.bufsize=65536:\
:pacing.send.delay=0:\
:pacing.send.count=0:\
:fasp=yes:
The parameter below is added to the bottom of the initparm.cfg to activate the FASP port(s)
# FASP listen ports
fasp:\
:listen.ports=(44001):
There are two types of licenses used to enable FASP. One is the Data Center (dc) license and the other is the End Point (ep) license, which can be compared to a Hub/Spoke type architecture.
The only restriction is the End Point license can only connect to a Data Center license. The End Point license cannot connect to another End Point license.
To display the license details run the following command - debase64, located in the Connect:Direct install_dir/etc directory, against the aspera_license file.
Below are examples of both types of licenses.
[cd42@ironman] /home/cd42/etc $ debase64 /home/cd42/ndm/cfg/ironman42/aspera-license
<?xml version="1.0" encoding="UTF-8"?>
<license version="1">
<!-- Void if modified -->
<product_id>34</product_id>
<customer_id>4988</customer_id>
<license_id>1012</license_id>
<expiration_date>2015-10-31</expiration_date>
<maximum_bandwidth>1000000</maximum_bandwidth>
<accounts>unlimited</accounts>
<connect_direct>yes</connect_direct>
<connect_direct_dc>yes</connect_direct_dc>
<peer_requirements>
<attribute>
<name>connect_direct</name> <!-- remote end must be c:d -->
<value>yes</value>
</attribute>
</peer_requirements>
</license>
==SIGNATURE==
lf6No6CoND5bC5l4KObWNdbhIS9EJmvdXuqV277b5JgnTVdi/omhKmJqGM63
2Isa5+0RA6esrT7AKbLWoHJD2rgYEWgfeaJ6hmnaX0yfqS7f9KuSkpJyLeor
oLXaUsVmLqSLMECATabdSJR9588Xb6Xddi+7yWmrZ0AOOHL3gWT6cVl+Ui/k
H2bj4ZlnisV18zqcAZOwBsue+/1SHqeY8ZfD6sIg1aPP/uX79fNNgHmEF4yh
K1kCIpmuprPDDNQIdC/zlzlJb5suQgZv7kmSqw10GzC8Bjdm8VlA0r1NFBF/
lnIJ7pwqZIVPG/WMMNUai/Y/w8kh9x/fxOctGZpXSQ==+0lskrd1/WEokld=
[cd42@ironman] /home/cd42/etc $ debase64 /home/cd42/ndm/cfg/ironman42/aspera-license
<license version="1">
<!-- Void if modified -->
<product_id>34</product_id>
<customer_id>4988</customer_id>
<license_id>1014</license_id>
<expiration_date>2015-10-31</expiration_date>
<maximum_bandwidth>1000000</maximum_bandwidth>
<accounts>unlimited</accounts>
<connect_direct>yes</connect_direct>
<connect_direct_ep>yes</connect_direct_ep>
<peer_requirements>
<attribute>
<name>connect_direct</name> <!-- remote end must be c:d -->
<value>yes</value>
</attribute>
<attribute>
<name>connect_direct_dc</name> <!-- remote end must be a c:d dc -->
<value>yes</value>
</attribute>
</peer_requirements>
</license>
==SIGNATURE==
NttNR1fJ7Ef6zCAyxR0idi6nVyddOh+/mTydwmNV4Q40dA3P790fHy+ShxLy
tvdBrPbS/WShX+srdphF37f7QLYRVruAJLtdWhdVm4FHq04EXlYVuIm3cGTU
iT175/P7LSQaygCnBkuoDCZMOdQDLdcr9P/WUtCb9Cw+ot14PX0mRfBJRkKd
eztIcn9QidXQpGDKRad8Gd5v41Ed521Oduyj2N1JlLYgAsYIWDkK35QDpl3X
+j7eTCJo/hDDGTS8VT6gtkZmOtRKz8Gf0YC1zKc1FlSIDBNR3LupscHX1E7n
Dwi7qcomgtPxOxMPzKpuShx7Vt7xzQZwuCUcXDnhlw==+uTYnwpq++=asd
Note: The licenses displayed in this document has been invalidated for use.
Here are the record statistics displaying the FASP parameters:
-------------------------------------------------------------------------------
PROCESS RECORD Record Id => CTRC
Process Name => sample Stat Log Date => 06/11/2015
Process Number => 5 Stat Log Time => 12:13:05.007
Submitter Class =>
Submitter Id => cd42@ironman42
Step Start Date => 06/11/2015 Step Start Time => 12:12:20.139
Step Stop Date => 06/11/2015 Step Stop Time => 12:13:05.007
Step Elapsed Time=> 00:00:45
Step Name => step01
From node => P
Rstr => N
SNODE => ironman42
Completion Code => 0
Message Id => SCPA000I
Short Text => Copy step successful.
Ckpt=>Y Lkfl=>N Rstr=>N Xlat=>N Scmp=>N Ecmp=>Y Ecpr=>97.61 CRC=>N
FASP=>Y FSPL=>FAIR FSBW=>10000000000 FMBC=>1 FBCS=>16777216
Zlvl=>1 Zwin=>13 Zmem=>4
Local node => S
From node => P
Src File => /home/cd42/tmp/aspera_file.txt
Dest File => /home/cd42/tmp/tmp/aspera_test_file.txt
Source Destination
Ccode =>0 Ccode =>0
Msgid =>SCPA000I Msgid =>SCPA000I
Bytes Read =>1784406495 Bytes Written=>1784406495
Recs Read =>77449 Recs Written=>77449
Bytes Sent =>42574961 Bytes Recvd =>42574961
Rus Sent =>2177 Rus Recvd =>2177
Ru Size =>65536
-------------------------------------------------------------------------------
Note: The FSBW value is written in bits.
[cd42@ironman] /home/cd42/work/ironman42 $ netstat -an | grep 44001
udp 0 0 9.55.125.12:46775 9.55.125.12:44001 ESTABLISHED
udp 0 0 9.55.125.12:44001 9.55.125.12:46775 ESTABLISHED
The udp ports are only used during an active session. As you can see the FASP port 44001 is assigned to ephemeral port 46775.
Since a Loopback test is being used, both an outbound and an inbound port are established.
Connect:Direct for UNIX FASP Information
UID
ibm11124001