Upgrading Faspex from 4.2.0 or Later

Before You Begin...

Before beginning the installation process for Faspex, you must be logged into your computer as an admin .

Download the latest version of IBM Aspera High-Speed Transfer Server,Common Components and IBM Aspera Faspex installers from the following locations:
- HST Server: http://downloads.asperasoft.com/en/downloads/1
- Common Components: http://downloads.asperasoft.com/en/downloads/6
- Faspex: http://downloads.asperasoft.com/en/downloads/6
Make sure your MySQL password are easily accessible.
Check the requirements in IBM Aspera High-Speed Transfer Server Admin Guide: Before Upgrading.
Install HST Server.
```
$ rpm -Uvh aspera-entsrv-version.rpm
```

Upgrading Faspex from 4.2.0 and Later

Back up your Faspex MySQL database by running the following asctl command:
```
# asctl faspex:backup_database
```
The asctl command uses mysqldump to backup Faspex's three MySQL databases to /opt/aspera/faspex/backup/time_stamp-version_number.revision_number

For example, the directory name may be 2016-04-15_140547-Faspex.4.0.0.100400.
Stop all Faspex services.
Before upgrading, stop all services related to Faspex, including Faspex, MySQL, and Apache. Use the following command:
```
# asctl all:stop
```
If your server is using a remote database, you must set the SKIP_MYSQL_UPGRADE environment variable to true to perform a successful upgrade.
```
# export "SKIP_MYSQL_UPGRADE=true"
```
For more information about using a remote database, see Configuring Faspex to Use a Remote Database (Faspex + MySQL).

Important: If you are using a local database, do not skip the MySQL upgrade.
Install the IBM Aspera Common Components.
Use the following commands with proper administrative permissions to run the installers (replacing version accordingly):
```
# rpm -Uvh ibm-aspera-common-version.rpm
```
Launch the Faspex installer.
Use the following commands with proper administrative permissions to run the installers (replacing version accordingly):
```
# rpm -Uvh ibm-aspera-faspex-version.rpm
```
Run the asctl:upgrade command.
```
# asctl faspex:upgrade
```
If you are upgrading from a version prior to 4.2.x, Faspex prompts you to provide the path to the database backup you made earlier:
```
Please provide the location of the Faspex database backup (e.g. backup/20XX-XX-XX_XXXXXX-Faspex.4.1.1.XXXXXX):
```
Confirm that your previous Faspex settings are still applicable.
Faspex prompts you to confirm if your previous Faspex settings are still applicable. Enter y to continue, n to change settings.
Important: Faspex 4.2.0 and later allows you to install the HTTP gateway service. Before installing HTTP gateway, see HTTP Gateway [BETA] Service for more information and to determine if you should enable this beta service.
If Faspex and HST Server are installed on the same server, restart the asperanoded service.
Run the following commands to restart the asperanoded service:
```
# service asperanoded restart
```

Logging In

Open a supported browser and enter the Faspex hostname or IP address followed by /aspera/faspex in the browser URL. For example:
http://faspex.asperasoft.com/aspera/faspex
or
http://198.51.100.24/aspera/faspex
Note: For security reasons, Faspex versions 4.0.3 and later by default only allow login using the hostname that is configured in the faspex.yml configuration file (the hostname you designated during installation). If you try to log in to the application from an unlisted hostname or perform a GET request with an unlisted hostname, Faspex returns the error, "Invalid hostname". To access Faspex from an alternate hostname, follow the instructions in Configuring the Faspex Web Server.
Log in with your credentials.
If SAML configurations are available, you can choose to log in with a configured SAML provider or with your Faspex user credentials.

If your administrator configured Faspex to use a default SAML configuration, Faspex automatically redirects you to the SAML login page. Login with your SAML credentials or login locally by bypassing the redirect.

If you need to login with your Faspex user credentials or if you need to log in using another SAML configuration, you can bypass the redirect by adding login?local=true to the end of the URL. For example: https://192.51.100.24/aspera/faspex/login?local=true.
If prompted, install IBM Aspera Connect.

You must have the latest version of Connect installed to transfer packages using Faspex. Faspex prompts you to install the Connect Browser if you do not have it installed or if your version is not the latest. If you install Connect, refresh your browser to start using Connect.

For more information, see Faspex and Connect.
If your license is out-of-date or expired, you must first update the license before you can access Faspex.
Faspex prompts you to update your license . You cannot interact with Faspex until entering and saving a valid license.For more information, see Updating Your License.
If you are upgrading from a version of Faspex prior to 4.0.1 and you had SAML configured, you need to add your SAML configuration metadata to your SAML Identity Provider (IdP) again. Metadata URLs now contain numbers to support multiple SAML configurations.
For information about configuring the IdP, see Configuring Your Identity Provider (IdP).