Installing Faspex with a Setup File

In order to create the setup file, you must first install IBM Aspera Enterprise Server. For more information on installing Enterprise Server, see Preparing Your System for Installation.

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.

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 about this process, see Step 3 in Installing Faspex with a Local Node. Finally, clear the Launch asctl to continue the Faspex setup checkbox and click Finish.
Create the setup files for the Aspera common and Faspex applications.
The filenames of the setup files must end with the .yml extension. As you run the following commands, you are prompted to set the desired configuration options used to install each application:
```
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
```

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

Your Faspex installation is now complete. To access Faspex from a browser, enter the Faspex hostname or IP address followed by /aspera/faspex in the browser URL. For example:

http://faspex.example.com/aspera/faspex

http://198.51.100.24/aspera/faspex

Note: As of Faspex 4.0.3, for security reasons, Faspex by default only allows login through the hostname configured in the faspex.yml configuration file (the hostname you designated during installation. If you try to log in to the web application from an unlisted hostname or perform a GET request with an unlisted hostname, Faspex returns the error, "Invalid hostname". To access Faspex from an alternate hostname, follow the instructions in Whitelisting Alternate Hostnames for Faspex.

As an admin, you must log in and activate Faspex with a valid license key before you can begin configuring users and sending or receiving packages. For more information on installing your license key, see Updating Your License.