Enabling IBM Cloud Object Storage (COS) - S3 Using the Command Line

You can configure your Aspera server to enable transfers with IBM Cloud Object Storage (COS) - S3.

Note: If IBM COS - S3 is on-premises, the Aspera transfer server must also be on-premises. If IBM COS - S3 is in the Cloud, the Aspera transfer server must be in the same region.

Prerequisites:

You have an IBM Cloud account.
You have a vault and know your access id and password.
You have installed an Aspera transfer server on a VM instance in IBM Cloud.
You can SSH into your VM instance as root.
Your Linux Kernel is 2.6.34 or higher. Run the following command to confirm:
```
$ uname -a
```
Your local and cloud firewalls allow FASP-required connections (TCP/22, TCP/33001, UDP/33001).

If IBM COS - S3 is in the Cloud, connect to your server through SSH and elevate to the root user.
```
# ssh -i identity_file -p 33001 user@host_ip_address
# sudo su -
```

Set the transfer user's docroot.

# asconfigurator -x "set_user_data;user_name,username;absolute,docroot"

Where docroot has the following syntax:

s3://access_id:secret_key@accessor_endpoint/vault_name

Open and modify /opt/aspera/etc/trapd/s3.properties.
```
# vi /opt/aspera/etc/trapd/s3.properties
```
IBM COS - S3 does not support retrieving the vault location, so this feature must be disabled. Find the line #aspera.session.check-bucket.transfer=true, uncomment it, and change the value to false. For example:
```
#Whether to check against cross-region transfers
#Default is true
aspera.session.check-bucket.transfer=false
```
Using vault names in requests does not work if DNS is not configured. To disable the use of vault names in the request hostname, find the line #s3service.disable-dns-buckets=false, uncomment the line, and change the value to true. For example:
```
#Disable use of bucket name in request hostname.
#Default (and recommended) is false
s3service.disable-dns-buckets=true
```

Enable the Trapd service.

# /opt/aspera/bin/astrap-config.sh enable

Restart Trapd to activate your changes.
```
# /etc/init.d/asperatrapd restart
```