Add HSTS in CP4I as a Transfer Server to Faspex5
IBM Aspera High Speed Transfer Server (HSTS) can be installed in an OpenShift environment as part of CP4I. This has been available for some time now. However, there were some limitations with the HSTS (CP4I) as compared to the HSTS deployed in virtual machines. For example, HSTS (CP4I) was not fully compatible with Aspera web applications such as Shares, Faspex 4 and Console.
Now, with the latest version of Faspex (Faspex5), HSTS (CP4I) can be used as transfer server for Faspex5.
This guide explains the steps on how to get this working.
Pre-Requisites
- Have a working HSTS deployed in OpenShift. Have access to issue 'oc' or 'kubectl' commands. Have access to login to OpenShift Console.
- Have a working Faspex5 deployed. Have admin access to the server.
Prepare HSTS in CP4I for the integration.
1. Get the NodeAPI user and password from the HSTS.
Login to the OpenShift Console and go to the namespace where HSTS is installed.
In the Open-shift Console, goto Workloads -> Secrets -> [deployment-name]-asperanoded-admin .
Take note of the username and password. This will be called as NodeUser and NodePassword.
2. Get the NodeAPI URL of the HSTS
|
oc -n <namespace> get routes
|
Take note of the URL. This will be the NodeURL.
3. Create access-key and secret. Replace NodeUser, NodePassword and NodeURL with the data collected above.
| curl -ki -u NodeUser:NodePassword https://NodeURL:443/access_keys -d '{"storage":{"type":"local", "path":"/data/"}}' |
Take note of the access-id and secret generated.
4. Create a sub folder for storing faspex packages. Replace ACCESSID, SECRET and NodeURL with the data collected above.
| curl -ki -u ACCESSID:SECRET https://NodeURL:443/files/create -d '{"paths": [ {"path": "packages", "type": "directory"} ]}' |
5. Get the TCP-Proxy External IP address
Look for External-IP of the TCP-Proxy and take note of it. This will called the TCP-Proxy-IP.
|
oc -n <namespace> get svc
|
Add HSTS to Faspex5
1. Login to Faspex5 as a user with admin access. Go to the 'Admin' page.
| https://FASPEX-URL/aspera/faspex/admin |
2. Click on "Nodes and Storage" and click on "Create node". Enter details as in the next screenshot.
Click on create and the node should be created.
3. Click on the created node and go to the 'Advanced Configuration' tab.
Enter the TCP-Proxy-IP as shown in the screenshot.
Click on Save to save the setting.
4. Next go to the "Storage Location' tab.
Add a new storage as explained in the next screenshot.
5. Once the storage location has been added, make it as the default inbox for Faspex. Refer to screenshot below.
6. That's it. Now you can start sending packages and the packages will be stored in the HSTS (CP4I). You'll find the packages created in the PVC storage of HSTS.