Configuring for Aspera on Cloud

If you plan to use the Aspera CLI to make transfers to or from an Aspera on Cloud workspace, you must configure both the CLI and AoC to work together.

Before You Begin

The instructions in this section assume that you have
  • A working Aspera on Cloud instance and at least one workspace.
  • The Aspera CLI, installed on a computer.

Configuration Steps

  1. Generate a key pair.
    Note: If you already have an SSH public/private key pair, you can use it for the Aspera CLI, but take care to have the public key in .pem format.
    1. At the command line, generate your SSH public/private key pair:
      >openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048
    2. If you are prompted to Enter passphrase (empty for no passphrase), press Enter or enter a passphrase.
    3. Extract the public key from the key pair, into a .pem file:
      >openssl rsa -pubout -in private_key.pem -out public_key.pem
      This is the public key that you will add to Aspera on Cloud in a later step.
  2. Add your public key to your AoC account.
    1. In Aspera on Cloud, go to the user menu and select Account settings.
    2. On the Account settings screen, in the Public Key field, paste the public portion of your public/private key pair.

      If you used the command sequence given in the previous step, the public key is named public_key.pem.

    3. Click Submit.
  3. Add your private key to your CLI installation.

    The file must be located in installation_directory\cli\etc.

  4. Edit the CLI config file.
    1. Locate the .aspera_cli_conf configuration file:
      installation_directory\cli\bin\.aspera_cli_conf
    2. In a text editor, edit the Aspera on Cloud section of the .aspera_cli_conf file to set the following:
      organization Your Aspera on Cloud organization name (usually your company name; usually set when your org was first created).
      hostname The hostname of your Aspera on Cloud server (usually takes the form of yourOrgNameibmaspera.com).
      privateKeyFilename The filename of the private key. If you used the command sequence given in a previous step, the filename is private_key.pem.
      username The email address for your account in Aspera on Cloud.
    3. Save the .aspera_cli_conf file.