Installing Faspex

The following instructions describe how to install IBM Aspera Faspex on your 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. Please refer to the topic Disabling SELinux for instructions on disabling SELinux.

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
```
Note: The installer attempts to create a user faspex and the associated home directory at /home/faspex. If your organization does not allow you to use the /home directory, create the "faspex" user first. Then set up a directory for the user “faspex”, and run the installation. The installer then uses the “faspex” user that you created and does not need to create the faspex user directory.
Launch asctl to continue Aspera Faspex setup process.

After the packages have been installed, Faspex automatically executes a setup command.
Follow the onscreen configuration instructions to complete the setup. 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.

If Faspex doesn't automatically run the setup command or an error halts the process, then you can run the command manually, as shown below.
```
$ asctl faspex:setup
```
Restart the Aspera Node Server.
In order to use Aspera 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:
```
# /etc/init.d/asperanoded restart
```

Your Faspex installation is now complete. To access the Faspex web interface, go to the following address within a browser window: http://server-ip-or-name/aspera/faspex.

As an Aspera Faspex Administrator, you can log in without activating Faspex. You must, however, have a valid license key to configure your users and begin sending or receiving packages. For more information on installing your license key, refer to Updating Your License.