Migrating Faspex to a New Machine

Move an existing Faspex server installation to a new system.

Important: You must migrate to the same version of 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 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.4.0.0.100400.

  2. Move files from the current server to the new server.
    • The database backup directory you just generated
    • 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))
    • C:\Program Files (x86)\Aspera\Faspex\config\faspex.yml (if you made advanced Faspex configurations)
    • C:\Program Files (x86)\Aspera\Faspex\lib\daemons\np\etc\keystore.jks
    Note: You cannot use the same Faspex license on multiple systems as this is a violation of your license terms. You can only use the Faspex license from your original system on your new system if you are immediately uninstall Faspex on the original system. If your original Faspex 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. On the new machine, install Faspex. Again, make sure you install the same version of Faspex that you had on the original server.
    For instructions on installing Faspex, see Faspex Installation Scenarios.
  4. Restore the database with the backup directory: 
     asctl faspex:restore_database /path/to/your_backup
  5. Restore secret.yml: 
    > copy C:\path\to\secret.yml C:\Program Files (x86)\Aspera\Faspex\config\secret.yml
  6. If you copied faspex.yml, restore the configuration file: 
    > copy C:\path\to\faspex.yml C:\Program Files (x86)\Aspera\Faspex\config\faspex.yml

    Open up faspex.yml in a text editor and look for the production section. Change Hostname and BaseURL to your new hostname or IP address.

  7. If you copied over certificates that you would like to continue using for your new Faspex installation, restore the certificates: 
     asctl apache:install_ssl_cert cert_filekey_file[chain_file]
  8. Clear the fasp_nodes table in MySQL: 
    > cd c:\Program Files (x86)\Common Files\Aspera\Common\mysql\bin\
> echo delete from fasp_nodes; > query.sql
> mysql -uroot -ppassword -D faspex < query.sql
  9. Restart Faspex services 
     asctl all:restart
  10. Update file storage for the tethered node:
    1. Go to Server > File Storage and select the drop-down menu next to localhost.
      • If the tethered node is local, select Edit. For Username and Password enter the Node API credentials.
      • If the tethered node is remote, select Add File Storage. Fill in the configuration details.
    2. Under Advanced Configuration, make sure the Primary transfer address or name reflects the new server's address or name.
    3. Click Update Node.