Parent topic: Installing Faspex
Installing Faspex

Preparing Your System for Installation

Before beginning the installation process for Faspex, you must be logged into your computer as an admin (or domain admin if you are in an Active Directory environment).
Warning: Due to incompatible common components, IBM Aspera Console and IBM Aspera Faspex cannot be installed on the same machine. Aspera does not support this combination. If you are running an older version of Faspex and Console on the same machine, contact Technical Support to move one of the applications to another system.
Make sure you have taken the following steps to prepare your system and to ensure that installation goes smoothly.
  1. Determine whether Faspex has a domain name.

    Aspera recommends creating a domain name for Faspex. If Faspex is configured to identify itself by IP address (rather than by domain name), then the URLs in your notification emails contain an IP address (for example, "https://10.0.0.1/aspera/faspex"). Some Web-based email services (such as Yahoo or Ymail, and Hotmail) have been known to automatically flag emails containing IP address links as "Spam," and move them to your Junk/Spam folder. If you do not have a domain name immediately available, then you can first configure Faspex with an IP address and then change it to use a domain name later.

    If you know that you will not be setting up a domain name, make sure that users add your Faspex "From" email address (for example, admin@faspex.example.com) to their address book or contact list. Doing so typically "white-lists" the address so that emails from Faspex are not automatically flagged and routed the Junk/Spam folder.

    CAUTION:
    Do not configure Faspex to use a domain name or hostname that contains underscore characters. Doing so could prevent you from logging into the server or cause other connectivity problems. Internet standards for domain names and hostnames do not support underscore characters.
  2. Upgrade Windows Installer to version 4 or higher.
    The Faspex installer requires Windows Installer version 4+ for successful configuration. You may download the latest version of Windows Installer from the Microsoft website.
  3. Download the latest Aspera installers.

    Download the latest version of IBM Aspera Enterprise Server, and IBM Aspera Faspex installers from the following locations:

    You are required to enter your organization's Aspera login credentials to gain access. If you need help determining your organization's access credentials, contact your Aspera account manager.

  4. Install Enterprise Server with a Connect server license.

    For instructions on installing your software and license, follow the steps in the IBM Aspera Enterprise Server or IBM Aspera Connect Server Admin Guide.

    The transfer server can be set up in either of the following configurations:

    • locally, on the same host as Faspex
    • remotely, on a separate host
    In the aspera.conf file (/opt/aspera/etc/aspera.conf) check the following:
    • Look for <persistent_store> in the <central_server> section, and be sure that it is set to enable (default value). This setting allows the retention of historical transfer data used by the stats collector.
    • Look for the <dir_allowed> setting for the faspex user, and ensure that it's set to true (default value).

    If you change settings, you must restart asperacentral and asperanoded. You can restart these services from the Windows Computer Management window, accessible from Manage > Services and Applications > Services. Right-click the service and select Restart from the menu.

  5. If you installed Enterprise Server on a remote host, you must configure the remote host to work with Faspex. For more information, see Working With Remote Servers.
You are now ready to install Faspex on your server. For more information on installing Faspex, see Installing Faspex with a Local Node.
Parent topic: Installing Faspex