IBM Aspera HST User Manual

353 pages

To Next Page

To Next Page

Page #1 background image

High-Speed Transfer

Server Admin Guide 3.9.1

PowerLinux

Revision:1978 Generated:04/05/2019 10:17

Table of Contents

Default Chapter2
- Table of Contents2
Introduction7
What's New9
Get Started with an Aspera Transfer Server9
Get Started as a Transfer Client10
Comparison of Aspera File Delivery and Synchronization Tools11
Installation and Upgrades13
- Requirements13
- Installing HST Server14
- Configuring the Firewall15
- Securing Your SSH Server16
  - Changing and Securing the TCP Port17
  - Configuring Transfer Server Authentication with the Host-Key Fingerprint19
- Testing a Locally Initiated Transfer20
- Updating the Product License21
- Uninstalling21
Set up the HST Server Web UI22
- Configuring the Apache Server to Host the HST Server Web UI22
- Configuring Your Web UI Settings25
- Customize the Appearance of the Web UI27
- Testing the Web UI27
- Configuring HTTP and HTTPS Fallback29
Server Set up Methods33
Set up Users and Groups33
- Setting up Transfer Users33
- Setting up Transfer Groups35
- Configuration Precedence38
- Setting up a User's Public Key on the Server38
- Testing a User-Initiated Remote Transfer39
Configure the Server from the Command Line40
- Aspera.conf - Authorization Configuration40
- Aspera.conf - Transfer Configuration42
- Controlling Bandwidth Usage with Virtual Links (Command Line)58
- Global Bandwidth Settings (Command Line)61
- Increasing Transfer Performance by Using an RTT Predictor62
- Aspera.conf - File System Configuration63
- Aspera.conf - Transfer Server Configuration69
- Aspera.conf - Filters to Include and Exclude Files71
- Server-Side Encryption-At-Rest (EAR)74
- Reporting Checksums75
- Server Logging Configuration for Ascp and Ascp 478
- Out-Of-Transfer File Validation80
- Inline File Validation83
- Inline File Validation with URI85
- Inline File Validation with Lua Script87
File Pre- and Post-Processing (Prepost)90
- Setting up Pre/Post Processing90
- Pre/Post Variables91
- Pre/Post Script Examples93
Email Notifications95
- Setting up Email Notifications95
- Email Notification Examples97
Ascp: Transferring from the Command Line with Ascp99
- Ascp Command Reference99
- Ascp General Examples114
- Ascp File Manipulation Examples116
- Ascp Transfers with Object Storage and HDFS118
  - Transfers with IBM Aspera on Demand and Cloud-Based HST Servers118
  - Writing Custom Metadata for Objects in Object Storage120
- Multi-Session Transfers121
- Using Standard I/O as the Source or Destination122
- Using Filters to Include and Exclude Files126
- Symbolic Link Handling132
- Creating SSH Keys133
- Reporting Checksums134
- Client-Side Encryption-At-Rest (EAR)137
- Comparison of Ascp and Ascp 4 Options138
- Ascp Faqs141
Ascp4: Transferring from the Command Line with Ascp 4144
- Introduction to Ascp 4144
- Ascp 4 Command Reference144
- Ascp 4 Transfers with Object Storage152
- Ascp 4 Examples153
- Built-In I/O Providers153
- Data Streaming Command Syntax154
- Ascp 4 Data Streaming Examples156
- Configuring Macos Server for Multicast Streams157
- Troubleshooting Stream Transfers158
Watch Folders and the Aspera Watch Service159
- Introduction to Watch Folders and the Aspera Watch Service159
- Choosing User Accounts to Run Watch Folder Services160
- Creating, Managing, and Configuring Services161
- Watch Folders164
- The Aspera Watch Service211
Aspera Sync218
- Introduction218
- Aspera Sync Set up222
- Running Async230
- Using the Aspera Watch Service with Aspera Sync257
- Aspera Sync Monitoring and Logging262
  - Asyncadmin Command-Line Options262
  - Logging264
- Troubleshooting Aspera Sync264
- Appendix268
Configuring for Other Aspera Products271
Set up HST Server for Node API272
- Overview: Aspera Node API272
- Node API Setup272
- Node Admin Tool275
- Configuring the IBM Aspera Noded Service277
- Securing the Node Service Behind a Proxy281
- Backing up and Restoring the Node User Database Records282
- Backing up and Restoring Access Keys (Tenant Data)282
- Backing up and Restoring a Node Database283
- Setting up SSL for Your Nodes284
- Installing SSL Certificates286
Authentication and Authorization289
- Introduction to Aspera Authentication and Authorization289
- Require Token Authorization: Set from the Command Line290
- Transfer Token Creation (Node API)291
- Transfer Token Generation (Astokengen)293
- Access Key Authentication296
- Basic Tokens304
- Bearer Tokens305
Highly-Available Redis Backend for an HST Server Cluster306
- Introduction306
- Requirements307
- Setup and Configuration307
- Start and Test the Cluster310
- Redis Sentinel Operation311
- Logging311
Asconfigurator Reference311
- The Asconfigurator Utility311
- Syntax and Usage311
- Examples313
- Reading Output314
- User, Group and Default Configurations315
- Trunk (Vlink) Configurations321
- Central Server Configurations321
- HTTP Server Configurations322
- Database Configurations324
- Server Configurations325
- Client Configurations329
Troubleshooting329
- Clients Can't Establish Connection329
- Error: Session Timeout During Ascp Transfers331
- Node API Transfers of Many Small Files Fails332
- Logs Overwritten before Transfer Completes332
- Disabling Selinux332
Appendix333
- Restarting Aspera Services333
- Docroot Vs. File Restriction334
- Aspera Ecosystem Security Best Practices335
- Testing and Optimizing Transfer Performance343
- Create an SSL Certificate (Apache)345
- Enable SSL (Apache)347
- Log Files348
- Preserving IBM Spectrum Scale Acls of Transferred Files352
- Product Limitations352
Technical Support353
Legal Notice353

Questions and Answers:

Need help?

Do you have a question about the IBM Aspera HST and is the answer not in the manual?

IBM Aspera HST Specifications

General

Product Name	IBM Aspera HST
Category	Server
Operating System Support	Linux, Windows, macOS
Purpose	High-speed data transfer
Protocol	Aspera FASP
User Interface	Web-based UI, command-line interface (CLI)
Bandwidth Control	Dynamic bandwidth control
API Support	REST API

Related product manuals

Preview: IBM i Series

Preview: IBM System x3550 M3

IBM System x3550 M3

Preview: IBM System x3250 M4

IBM System x3250 M4

IBM H SERIES RS/6000

Preview: IBM System x3650 M3 4255

IBM System x3650 M3 4255

Preview: IBM x3550 - System - 7978

IBM x3550 - System - 7978

Preview: IBM System x3400 Type 7975

IBM System x3400 Type 7975

Preview: IBM Redboks System x3550 M4

IBM Redboks System x3550 M4

Preview: IBM x3650 - System M2 - 7947

IBM x3650 - System M2 - 7947

Preview: IBM x3200 - System M3 - 7328

IBM x3200 - System M3 - 7328

Preview: IBM System x3650 M4 Type 7915

IBM System x3650 M4 Type 7915