Product Setup

A walkthrough of the setup process.

Important: If this is a product upgrade, ensure that you have reviewed all prerequisites detailed under the topic "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.

    Warning: When upgrading from 2.7.X to 3.X on Windows, please be aware that user names for 3.X are case sensitive.
  3. Open the installation package and select the setup type

    After downloading, open the installation package and follow the on-screen instructions.

    After the license agreement screen, click the desired setup type. If you are upgrading from a previous version, the installer will skip this step.

    The following setup options are available:

    Setup Type Description
    Typical Install the standard Desktop Client.
    Custom Select the features and the path to install.
    Complete (Same as the Typical setup type).
  4. Select features and install path (Custom setup type)

    Select the destination folder for the installation. Under Install this application for:, choose between Anyone who uses this computer (all users) to allow access for all system users, or Only for me to allow only your user account to use the application.

    Custom setup type - select features
  5. Set up Aspera service account

    On Windows Vista, 2003, 2008, and 7, the installer prompts you to create or update an Aspera service account that runs the services for Aspera products. These services include the following:

    • Aspera Sync

    By default, the user name is svcAspera. If your machine is not joined to a Windows domain, then a local user (such as the default svcAspera) is all that is required to run Aspera services. If your machine is already joined to a domain, or you need to support requirements #2 and/or #3 below, then the type of account specified will vary. Please refer to the following table:

    No. Requirement Type of Service Account User
    1 Provision local transfer users only. Local account. Domain account with local admin privileges can be used, but is not required.
    2 Provision Active Directory accounts for transfer users (users who wish to transfer with your server are authenticated through Active Directory). Domain account with local admin privileges.
    3 Transfer users store files on a remote file system (not on your server machine), such as an SMB file share. Domain account with local admin privileges. In some cases, additional actions are required to support this requirement. Please see the aspera knowledgebase or contact Aspera Technical Support for assistance.

    If the server is configured to accept the domain user login, use a domain account that has been added to the local administrator's group to run the services. You must create this domain account on your Domain Controller first.

    If the local account does not already exist, enter new credentials and click Next. If the account already exists (for example, if created for the previous installation), enter the account password and click Next. If the existing user's password you have entered is incorrect, or you wish to change the Aspera service user, refer to Updating Aspera Service Account.

    Set up the Aspera service account.

    If you are entering details for a domain account, then the user name must be in the form "username@fully.qualified.domain.name." Please refer to the example below.

    Set up the Aspera service account.
  6. Install the license

    When installation is finished, launch the application to add or update the license. Go to:

    Start Menu > All Programs > Aspera > Client > Client

    If this is a fresh install, an Enter License window appears. Either click 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 appears in the window. Verify that it is correct and click Close.

    The Enter License window.

    /opt/aspera/etc/aspera-license

    When finished, save and close the file. To verify the license info, run the following command:

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

  7. (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 Command window to validate aspera.conf:

    Platform Command
    32-bit Windows "C:\Program Files\Aspera\Client\bin\asuserdata" -v
    64-bit Windows "C:\Program Files (x86)\Aspera\Client\bin\asuserdata" -v
  8. Troubleshooting
    Problem Description
    Installer freezes You may have another Aspera product running on your computer. To stop all FASP transfer-related applications and connections, see Before Upgrading.