Upgrading Console to the Current Version

If an older version of IBM Aspera Console is already installed on your machine, upgrade to the newest version. Aspera supports upgrading from the following versions.
  Windows 2012 (64-Bit) Windows 2008 R2 (64-Bit) Windows 2008 (32-Bit)
Console and Common Versions
  • Console 3.1.1
  • Console 3.1.0
  • Console 3.0.7
  • Console 3.0.6
  • Console 3.0.5
  • Console 3.0.3
  • Console 3.0.2
  • Console 3.0.1
  • Console 2.3.2
  • Console 2.0.1
  • Console 3.1.1
  • Console 3.1.0
  • Console 3.0.7
  • Console 3.0.6
  • Console 3.0.5
  • Console 3.0.3
  • Console 3.0.2
  • Console 3.0.1
  • Console 2.3.2
  • Console 2.0.1
  • Console 1.7.3
  • Console 1.5.6
  • Console 3.1.1
  • Console 3.1.0
  • Console 3.0.7
  • Console 3.0.6
  • Console 3.0.5
  • Console 3.0.3
  • Console 3.0.2
  • Console 3.0.1
  • Console 2.3.2
  • Console 2.0.1
  • Console 1.7.3
  • Console 1.5.6
If you are upgrading from a version not listed above, contact Aspera Support for further information.
Note: As of Console 3.0.3+, Console stores license information in the database, rather than in a file located at C:\Program File (x86)\Aspera\Management Console\config. If a license is added to the directory before the upgrade script is run, the script migrates the license information from the file into the database and deletes the file. To modify your license, see Updating your Console License.
  1. Upgrade to Windows Installer 4+.
    The Console installer requires Windows Installer 4+ for a successful configuration. You may download the latest version of Windows Installer from the Microsoft website: www.microsoft.com/en-us/download/details.aspx?id=8483
  2. Back up the Console database using an asctl command. Open a Command Prompt (Start > All Programs > Accessories >Command Prompt) and execute the following command:
    > asctl console:backup_database
  3. Stop Console and all related services.
    Run the following asctl command:
    > asctl all:stop
  4. Download Console installation components.

    Use the credentials provided by Aspera to download the Console installer from the Aspera website: http://downloads.asperasoft.com/en/downloads/3

  5. Install components.
    Important: If you have set a custom database backup path with the SQL_EXPORT_DIR environment variable, execute the installer in the same command prompt (set SQL_EXPORT_DIR=db-export-path), so that the installer can use the variable.

    Double-click the Console installer to start the installation.

  6. Enter the user name and password of the system account used as the Aspera service account.
    This account can be either a local account or an Active Directory account. If the Aspera service account is an existing user, enter the user's password. Otherwise, create a new user name and password. By default, the user name is svcAspera. If the existing user's password you have entered is incorrect, or you want to change the Aspera service user, see Managing the Aspera Service Account.

  7. Click Install.
  8. Upon completion, the installer will prompt you to execute the asctl upgrade command. If you did not select the option, run the asctl upgrade command in a Command Prompt:
    > asctl console:upgrade
  9. Optional: Upgrade legacy nodes.
    Upgrade your legacy nodes (running an Aspera transfer product prior to version 3.4.6) to take advantage of Console features. For more information on converting your legacy nodes, see Converting Legacy Nodes.