Installing Faspex with a Remote Node

In order to make transfers, Faspex communicates with a transfer server product, either IBM Aspera Enterprise Server or IBM Aspera Connect Server, using the Node API. The Node API is a daemon on the transfer server that offers REST-inspired file operations and a transfer management API. A local, remote, or cloud system installed with a transfer server is called an Aspera node. When installing Faspex on the same machine as a transfer server, Faspex automatically configures the local node's aspera.conf configuration file and sets up a Node API user. When installing Faspex on a machine without a transfer server, you must configure a remote transfer node for use with Faspex and connect that node to Faspex during the installation process. For more information about configuring a remote transfer node, see Configuring a Remote Transfer Node for Faspex.

Note: The following instructions assume you have already completed the steps in Preparing Your System for Installation.

The steps below describe how to install Faspex and connect it to a remote transfer node:

  1. Launch the Faspex installer.

    Use the following commands with proper administrative permissions to run the installers (replacing version accordingly). Order is important; Aspera Common Components must be installed first.

    # rpm -Uvh aspera-common-version.rpm
    # rpm -Uvh aspera-faspex-version.rpm
  2. Configure the remote transfer node for use with Faspex. Follow the instructions in Configuring a Remote Transfer Node for Faspex.
  3. Launch asctl to continue the Faspex setup process. Run the following command:
    asctl faspex:setup
    Follow the onscreen configuration instructions to complete the setup.
    Tip: You may choose not to run the setup command if you plan on installing Faspex from a setup file. For more information on installing from setup files, see Installing Faspex with a Setup File.
  4. When prompted to perform a streamlined or detailed setup, choose to perform a detailed (d) setup.
    Prompt Requirement
    What base port should the Mongrel servers start at? The default is 3000.
    Do you want to run the transfer server locally? (y/n) You must choose n.
    What address or hostname should the Faspex web server use to communicate with the transfer server? Enter the hostname or IP address of your remote transfer node.
    Note: You can change this after installation using a rake command. For more information, see Configuring Server Settings with Rake Tasks.
    What address or hostname should end users (with Aspera Connect) use to communicate with the transfer server? Enter the hostname or IP address of your remote transfer node.
    Choose a login name for the new admin user Enter a login name for the admin user.
    Enter the email address for admin Enter the email address to associate with the admin user.
    Enter the password for admin Enter a password for the admin user. When you log in for the first time, you are required to change your password.
    Enter IP address of network interface for apache to listen on Enter the hostname or IP address of your Faspex server.
    What hostname or IP address should Apache use to identify itself ( in the SSL certificate)? The default is 127.0.0.1.
    What port would you like to run Apache http on? The default is 80.
    What port would you like to run Apache https on? The default is 443.
    Would you like to generate a self-signed SSL certificate, or install your own? The default is skip (s). For more information about the SSL certificate, see Working With SSL.
  5. Log into Faspex with the admin user credentials you entered above.
    To access Faspex, open a browser and enter the Faspex hostname or IP address followed by /aspera/faspex in the browser URL. For example:

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

    or

    http://198.51.100.24/aspera/faspex

  6. Enter a valid license. For more information, see Updating Your License.
  7. Add the Node API user credentials in to connect the node in Faspex.
    Go to Server > File Storage, click the arrow next to the node, and select Edit from the drop-down menu.

    Enter your Node API username and password. Select Test Connection. If Faspex does not display the message "Connection succeeded!", see Troubleshooting File Storage Errors for help understanding the error.

  8. Click Update Node.
Your Faspex installation is now complete.