Before Upgrading

Steps to take before upgrading your Aspera product.

Print this page

WARNING! When upgrading from Connect Server versions older than 3.2.1, the Connect Server system-level security settings are not preserved and must be reconfigured. For instructions on enabling or disabling Connect Server system-level security, see "Configuring Apache" (second-to-last step).

The installer for Aspera Connect Server automatically checks for a previous version of the product on your system. If a previous version is found, the installer automatically removes it and upgrades your computer to the newer version.

Although the installer performs your upgrade automatically, we highly recommend completing the tasks below before starting the installation/upgrade process. If you do not follow these steps, you risk installation errors or losing your former configuration settings. Skip any steps that do not apply to your specific product version.

IMPORTANT NOTE: You cannot upgrade directly between different Aspera transfer products (such as from Point-to-Point to Client, or from Point-to-Point to Enterprise Server). To upgrade, you need to back up the configuration, uninstall the product, and perform a fresh install of the new version of the product. .

  1. All Versions - Verify existing product version

    Depending on your current product version, the upgrade preparation procedure may differ. In a Terminal window, execute this command:

    $ ascp -A

    You can find the version number preceding the product name.

  2. All versions - Stop all fasp transfer-related applications and connections.

    Before upgrading the application, close the following applications and services:

    • ascp connections
    • SSH connections
  3. All versions - Backup the files

    Depending on the version of your previous installation, backup the files in the specified locations:

    Version Folder
    2.0.2 to 2.7+
    • /opt/aspera/etc/(Server config, web config, user settings, license info)
    • /opt/aspera/var/(Pre- and Post-Processing scripts, Connect Server)
    2.0.1 and earlier
    • /var/opt/aspera/etc/(Server config, web config, user settings, license info)
    • /usr/local/aspera/var/(Pre- and Post-Processing scripts, Connect Server)

    If a previous version of Connect Server (Aspera Web) was set up and customized on your computer, backup the customized Connect Server installation in the following location and use it as a template to modify the new one: 

    /opt/aspera/var/webtools/
  4. Version 2.1.x - Verify Aspera's configuration file (aspera.conf) version

    If you are upgrading from Connect Server version 2.1.x and have HTTP Fallback configured, you may need to modify aspera.conf file to avoid upgrading errors. Open aspera.conf with a text editor:

    /opt/aspera/etc/aspera.conf

    Remove the version="2" from the opening tag <CONF>: 

    <CONF version="2">
...
  5. Version 2.0.1 and earlier - Backup and restore Web UI authentication info

    If the existing installation is version 2.0.1 and prior, you may need to restore the Connect Server's authentication info after the installation. Backup this file:

    /var/opt/aspera/webpasswd

    After the upgrade, restore the file to the following directory: 

    /opt/aspera/etc/