Installing Faspex with a Local Node

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

Follow the steps below to install Faspex on a machine running Enterprise Server on the same machine.

Note: Before installing Aspera Faspex, make sure you disable SELinux (Security-Enhanced Linux) on your RedHat, CentOS or Fedora machine. SELinux, an access control implementation, causes the Faspex installation to fail with an error. To address this issue, disable SELinux on your machine. For instructions on disabling SELinux, see Disabling SELinux.
  1. Launch the Faspex installer.
    Note: The installer attempts to create a faspex system user and the associated home directory at /home/faspex. If your organization does not allow you to use the /home directory, first create the faspex user and configure the user directory with the following commands:
    # mkdir -p /home/faspex/faspex_packages
    # chown faspex:faspex /home/faspex/
    # chown faspex:faspex /home/faspex/faspex_packages 
    The installer uses the faspex user that you created and does not need to create the faspex user directory.

    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. 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.
    These instructions include identifying whether you want to perform a streamlined (s) setup or a detailed (d) setup. Select detailed (d) to view and edit advanced configuration options.
    Important: If you installed Enterprise Server on a remote host, you must perform a detailed (d) setup. First, configure the remote host to work with Faspex (see Configuring a Remote Transfer Node for Faspex), then follow the instructions in Installing Faspex with a Remote Node.
  3. Restart the Aspera Node Server.

    In order to use Faspex, the Aspera Node Server must be running. If you did not choose to restart the Aspera Node Server when prompted during the setup process, or if it has been stopped, you must restart it before using Faspex.

    You can use the ps command to check whether the node server is running. For example:
    # ps -ef | grep asperanoded
    To restart asperanoded:
    # service asperanoded restart
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

or

http://198.51.100.24/aspera/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.