Installing Faspex with a Setup File

Faspex is a file exchange application built upon IBM Aspera Enterprise Server and other Aspera transfer products as a centralized transfer solution. In order to make transfers, Faspex communicates with a node through the Node API. The Node API is a daemon on the transfer server that offers REST-inspired file operations and a transfer management API.

It is possible to automate the installation of Faspex by using setup files to define configuration options that are manually set during a typical installation. You must first use the asctl command to generate a setup file with the desired configuration information. After you have created the setup files, you can use them to install Faspex.

Generate the Setup Files

  1. Install the Aspera common applications and the Faspex packages, in that order.
    Double-click the Faspex installer.
    Note: If your Windows Operating System has User Account Control (UAC) enabled, confirm or enter the admin password to allow the installer to make changes to your computer.
    After the license agreement screen, select a Typical installation and associate the Aspera services with a user account. The default user name is "svcAspera". For more information, see The Aspera Service Account. Finally, clear the Launch asctl to continue the Faspex setup checkbox and click Finish.
  2. Create the setup files for the Aspera common and Faspex applications.
    The filenames of the setup files must end with the .yml extension. Run the following commands:
    > asctl apache:create_setup_file /path/to/apache_setup_file.yml
> asctl mysql:create_setup_file /path/to/mysql_setup_file.yml
> asctl faspex:create_setup_file /path/to/faspex_setup_file.yml
    You are prompted to set the desired configuration options used to install each application.

Install Faspex Using the Setup Files

Use the setup files to install the Aspera common and Faspex applications.
Run the following commands manually or through a script to install the applications:
> asctl apache:setup_from_file /path/to/apache_setup_file.yml
> asctl mysql:setup_from_file /path/to/mysql_setup_file.yml
> asctl faspex:setup_from_file /path/to/faspex_setup_file.yml