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.
The steps below describe how to install Faspex and connect it to a remote transfer node:
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
asctl faspex:setupFollow the onscreen configuration instructions to complete the setup.
|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.|
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.