Product Setup

Install the IBM Aspera transfer product and set up your computer for FASP file transfers.

Important: If this is a product upgrade, ensure that you have reviewed all prerequisites detailed under "Before Upgrading."
  1. Download the IBM Aspera product installer.

    Download the installer from the link below. Use the credentials provided to your organization by Aspera to access:

    If you need help determining your firm's access credentials, contact Technical Support.

  2. For product upgrades, ensure you have prepared your machine to upgrade to a newer version.

    Although the installer for Aspera Client performs your upgrade automatically, Aspera highly recommends completing the tasks identified in the topic Before Upgrading. If you do not follow these steps, you risk installation errors or losing your former configuration settings.

  3. Run the installer

    When downloaded, run the installer using the following commands and with the proper administrative permissions. Replace the file name accordingly.

    OS Commands
    $ rpm -Uvh aspera-scp-client-version.rpm 
    $ dpkg -i aspera-scp-client-version.deb
  4. Install the license.

    The following table describes two ways to install the license: through the GUI or via command line.

    Method Instructions
    GUI To install the license via the GUI, execute asperascp in a Terminal (as a root user) to launch the application. If this is a fresh install, an Enter License window appears. You may click the Import License File and select the license file, or Paste License Text to copy-and-paste the license file's content. When finished, the license information will appear in the window. Verify that it is correct and click Close.
    The Enter License window.
    Terminal To install the license from the command line, create the following file and paste your license key string into it:
    When finished, save and close the file. Use this command to verify the license info:
    $ ascp -A

    If you are updating your product license after the installation, see Updating the Product License.

  5. Convert the old aspera.conf file manually (necessary only when upgrading from product version 2.2 or earlier)

    For product versions 2.5+, the docroot settings have been moved to the Aspera configuration file, aspera.conf. When upgrading from product version 2.2 or earlier, the installer converts your old configuration files to the new format, using a "strict" method. If the old aspera.conf file has errors or unrecognized directives, the conversion will fail. To review the errors, run a strict conversion manually. Change aspera.conf's path if it is not in the default location.

    $ cd /opt/aspera/etc
    $ sudo asconfigurator -T -F convert_conf_V1_data ./aspera.conf

    If an error occurs during the conversion, use the relaxed conversion method:

    $ cd /opt/aspera/etc
    $ sudo asconfigurator -F convert_conf_V1_data ./aspera.conf 
  6. (For upgrades) Check aspera.conf for errors

    When upgrading your Aspera product to a newer version, it is recommended that you check the aspera.conf configuration file for errors. Run the following command in a terminal window to validate aspera.conf:

    $ /opt/aspera/bin/asuserdata -v