Restoring your Faspex Database

Aspera strongly recommends backing up your Faspex database as a precaution in case of system failure. You may also want to restore your Faspex configuration folder and database on a new machine.

The restored version of your Faspex and database must match the version of Faspex on the machine to which you are restoring.
  1. Restore your Faspex database by copying the backup directory to the new location and run the following, where dir is the directory where the backup has been copied:
    # asctl faspex:restore_database /dir
  2. Reset the Faspex hostname.
    Change the hostname by running the following from a Windows command prompt:
    # asctl apache:hostname hostname
  3. Change the hostname or IP address in your faspex.yml file. The faspex.yml file can be found at the following location: /opt/aspera/faspex/config/secret.yml. Change Hostname: and BaseUrl: to include the new hostname or IP address.
  4. Update the aspera.conf file with the new hostname using the following asconfigurator command:
    asconfigurator -x "set_server_data;server_name,hostname"
  5. Create a new node admin user. Run the following command:
    # asnodeadmin -a -u nodeadmin -p password -x faspex
  6. Restart Aspera services.

    After updating aspera.conf, restart the following services:

    • Aspera Central
    • Aspera NodeD
    • Aspera HTTPD
  7. Copy your SSL certificates and keys.

    If you have a custom SSL Certificate, or want to preserve the existing one, copy the SSL certificates and keys to the following locations:

    • /opt/aspera/common/apache/conf/server.crt
    • /opt/aspera/common/apache/conf/server.key
    Keep a backup of those files in that directory.
  8. Copy the secret.yml file from your backup to /opt/aspera/faspex/config/secret.yml. Keep a backup of the original secret.yml file in the directory.
  9. Restart Faspex.
    # asctl faspex:restart
  10. Migrate the server to the new public IP (or EIP in Amazon if you're using an On-Demand system), or change your DNS to point the hostname to the new server IP.
  11. Modify the localhost configuration.
    Launch Faspex from a browser and log in using the Faspex admin account. Go to Server > File Storage and edit the localhost node. (Click the box icon next to localhost and select Edit.) In the Basic Configuration section, enter the username and password you specified when you created the node admin user in the steps above.
    Note: Remote storage locations should be accessible without changes.
Note: If you created post-processing scripts, you must copy and restore them manually. For more information on post-processing scripts, see Enabling Post-Processing Scripts.

Each email template notification you have customized must be regenerated from the UI. For more information, see Configuring Email Notifications.