Installing Faspex with a Setup File

You can automate Faspex installation by using setup files generated by the asctl command-line interface. The setup files define configuration options that are manually configured during a typical installation.

Warning: Due to incompatible common components, IBM Aspera Console and IBM Aspera Faspex cannot be installed on the same machine. IBM Aspera does not support this combination.

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

Before installing Aspera Faspex:
  • If you have an existing MySQL database installed, stop the MySQL service.
  • If you have an existing Apache HTTP server installed, stop the Apache server.
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

First Time Log In and Licensing

  1. Open a supported browser and enter the Faspex hostname or IP address followed by /aspera/faspex in the browser URL. For example:

    http://faspex.asperasoft.com/aspera/faspex

    or
    http://198.51.100.24/aspera/faspex
    Note: For security reasons, Faspex versions 4.0.3 and later by default only allow login using the hostname that is configured in the faspex.yml configuration file (the hostname you designated during installation). If you try to log in to the 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 Configuring the Faspex Web Server.
  2. Enter the login credentials you created for the admin user and click Login.
    When logging in for the first time, you must change your password and then login with the new password.
  3. Configure a valid license.
    You cannot interact with Faspex until configuring a valid license.
    1. Click Browse to upload a license file from your computer, or paste the contents of your license into the box.
    2. Click Update and validate license.