IBM Support

How to set up and test FASP with Connect:Direct for UNIX

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

v4.2.x   v4.3.x   v6.0.x   v6.1.x

FASP Getting Started Guide.  It is very important that you run the iPerf™ tests to confirm the network capability for running FASP.

[{"Type":"SW","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSKTYY","label":"IBM Sterling Connect:Direct for UNIX"},"ARM Category":[{"code":"a8m0z000000cwUgAAI","label":"CONFIGURATION"}],"ARM Case Number":"","Platform":[{"code":"PF061","label":"UNIX"}],"Version":"6.0.0;6.1.0;and future releases"}]

UID

ibm11124001