Backing Up Faspex from the Command Line

Aspera strongly recommends backing up your IBM Aspera Faspex configuration and database as a precaution in case of system failure. You can also choose to restore Faspex on a completely new workstation on which you've installed Faspex.

  1. Back up your Faspex MySQL database by running the following asctl command:
    > asctl faspex:backup_database

    The asctl command uses mysqldump to backup Faspex's three MySQL databases to the following directory:

    OS Version Path
    32-bit Windows C:\Program Files\Aspera\Faspex\Backup\time_stamp-version_number.revision_number
    64-bit Windows C:\Program Files (x86)\Aspera\Faspex\Backup\time_stamp-version_number.revision_number
    For example, the directory name may be 2016-04-15_140547-Faspex.
  2. Back up the secret.yml file located at: C:\Program Files (x86)\Aspera\Faspex\config\secret.yml. This file must be backed up and restored for the restored Faspex to correctly work with remote nodes.
  3. Back up your Faspex, Apache and MySQL application files.

    Aspera also recommends that you back up your Faspex, Apache and MySQL application files, which, in addition to the database backup, yields a full backup of the applications required to run Faspex. You can find the application files in the following directories:

    Application Location of Application Files Files to Back Up
    Faspex C:\Program Files (x86)\Aspera\Faspex\
    • faspex.rb.yml
    • config/*.yml
    • /config/mongrel_cluster/mongrel_cluster.yml
    • /config/aspera.faspex.*.aspera-license
    Apache C:\Program Files (x86)\Common Files\Aspera\Common\apache
    • apache.rb.yml
    • /conf/*.key
    • /conf/*.crt
    • /conf/extra/httpd-ssl_template.conf
    • /custom/
    MySQL C:\Program Files (x86)\Common Files\Aspera\Common\mysql
    • database.rb.yml
  4. If you configured SSL for Faspex, backup your SSL certificate files.
    Locate and copy the server.crt and server.key files to a different location. The files can be found in the following locations:
    • C:\Program Files (x86)\Common Files\Aspera\Common\apache\conf\server.crt
    • C:\Program Files (x86)\Common Files\Aspera\Common\apache\conf\server.key

For instructions on restoring your Faspex configuration and database, see Restoring your Faspex Database.