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:

    /opt/aspera/faspex/backup/time_stamp-version_number.revision_number
    For example, the directory name may be 2016-04-15_140547-Faspex.4.0.0.100400.
  2. Back up the secret.yml file located at: /opt/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 /opt/aspera/faspex
    • faspex.rb.yml
    • config/*.yml
    • /config/mongrel_cluster/mongrel_cluster.yml
    • /config/aspera.faspex.*.aspera-license
    Apache /opt/aspera/common/apache
    • apache.rb.yml
    • /conf/*.key
    • /conf/*.crt
    • /conf/extra/httpd-ssl_template.conf
    • /custom/
    MySQL /opt/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:
    • /opt/aspera/common/apache/conf/server.crt
    • /opt/aspera/common/apache/conf/server.key

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