Moving your Console server to a new machine


This article describes how to move your Console installation to a new system.

You must move to the same version of Console. For example, if you have Console 3.0. on your old system, your new system must also have Console 3.0.


1. Backup the database from your original Console installation.

Run the following command, which will save a backup:

# asctl -v console:backup_database
Note: On Windows, you must run Command Prompt as an Administrator to use asctl

The backup will be saved to the following location:

  • Linux: /opt/aspera/console/backup/timestamp
  • Windows: C:\Program Files (x86)\Aspera\Management Console\backup\timestamp

2. Move files to the new machine

You are now ready to move files from your old machine to the new one. Copy the following files from your old machine:


  • Database backup directory
  • /opt/aspera/console/config/secret.yml
  • /opt/aspera/common/apache/conf/*.key (if you have your own SSL certificate(s))
  • /opt/aspera/common/apache/conf/*.crt (if you have your own SSL certificate(s))


  • Database backup directory
  • C:\Program Files (x86)\Aspera\Faspex\config\secret.yml
  • C:\Program Files (x86)\Aspera\Common Files\Aspera\Common\apache\conf\*.key (if you have your own SSL certificate(s))
  • C:\Program Files (x86)\Aspera\Common Files\Aspera\Common\apache\conf\*.crt (if you have your own SSL certificate(s))

Note: You cannot use the same Console license on multiple systems as this is a violation of your license terms.

You may use the Console license from your original system on your new system if you will be uninstalling Console on the original system right away. For more information on where your license is located, see this article.

If your original Console installation needs to stay up and running for a short period, you may ask your account manager for a temporary license to use on your new installation.

3. Prepare your new system

The rest of the instructions apply to the new machine.

On the new machine, ensure Console is installed.

Download the installer and run through the Console setup as described in the product manuals.

4. Stop Console

Before restoring the database, stop Console:

# asctl console:stop

5. Restore the database

Restore the database with the backup directory:

# asctl -v console:restore_database backup_dir

6. (optional) Install your certificates

If you copied over certificates that you would like to continue using for your new Console installation, run the following command:

# asctl apache:install_ssl_cert cert_file key_file [chain_file]

7. Start Console

# asctl console:start

8. You have now finished moving your installation to your new system.

Powered by Zendesk