Configuring HTTP and HTTPS Fallback

HTTP fallback serves as a secondary transfer method when the Internet connectivity required for Aspera FASP transfers (UDP port 33001, by default) is unavailable. When HTTP fallback is enabled and UDP connectivity is lost or cannot be established, the transfer will continue over the HTTP protocol. These instructions describe how to enable and configure HTTP/HTTPS fallback.

Prerequisites:

To enable HTTP fallback for IBM Aspera Faspex, you must configure the feature in both Faspex and the associated transfer node that is running IBM Aspera High-Speed Transfer Server.
When Faspex and the HST Server are installed on the same machine, the Faspex installation process configures both automatically. When HST Server is remote, configure the transfer server and firewall ports in either of the following ways:
- Set HTTP/HTTPS to defaults ports (8080 + 8443) and open firewall ports on 8080/8443.
- Set HTTP/HTTPS to standard ports (80 + 443) and open firewall ports on 80/443.
Additionally, the transfer server fallback settings must match the Faspex fallback settings. If the settings don't match, Faspex returns a "Package creation failed" error. Ensure that transfer server has HTTP/HTTPS fallback enabled.
Configure your HST Server web UI. For additional information on configuring different modes and testing, see the Aspera KB Article "HTTP fallback configuration, testing and troubleshooting."
Your Aspera HTTP daemon (asperahttpd) is running with sufficient privileges so that it can modify file ownership.

Limitations:

Folders that are symbolic links cannot be downloaded directly by using HTTP fallback. Folders that are symbolic links are processed correctly when their parent folder is the source.
HTTP fallback can only follow symbolic links. Settings in aspera.conf or in the command line are ignored.
HTTP fallback attempts to transfer at the target rate but is limited by TCP.
HTTP fallback does not support pre-post processing or inline validation.

Process:

Go to Server > Configuration > Transfer Options and select Enable HTTP Fallback.
Go to Server > Configuration > Security and select Encrypt Transfers.

Note: If HTTPS fallback is enabled on the transfer server, encrypted transfers must be enabled in Faspex.
Confirm your HTTP fallback port number.
To confirm your HTTP fallback port number, run the following asctl command:
```
# asctl faspex:http_fallback_port
```
If you need to modify the Faspex HTTP port, add the port_number to the command:
```
# asctl faspex:http_fallback_port port_number
```
Important: Do not use this command if Faspex and your transfer server are on the same machine. If you modify the HTTP fallback port, HTTP fallback fails because Apache is hard-coded to route traffic to asperahttpd on port 8080.
(In HST Server) Configure HTTP/HTTPS fallback settings.
You can configure HTTP/HTTPS fallback from the HST Server GUI or by editing aspera.conf.
Configuring HTTP/HTTPS fallback from the GUI:

Launch the transfer server and go to Configuration > Global > HTTP Fallback.

Review the following settings:
- In the Enable HTTP row, select Override and set to true.
- If you want to allow fallback over HTTPS, in the Enable HTTPS row, select Override and set to true.
Configuring HTTP/HTTPS fallback by editing aspera.conf:
Run the following commands:
- To view the current HTTP settings in aspera.conf:
```
$ /opt/aspera/bin/asuserdata -b -t
```
Confirm the HTTP fallback settings in aspera.conf as shown in the example below. enable_http should be set to true, while the value shown for http_port should match what was displayed when you ran the command asctl faspex:http_fallback_port (default: 8080).
```
<CONF version="2">
  ...
  <http_server>
    ...
    <enable_http>true</enable_http>     
    ...
    <http_port>8080</http_port>         
    ...
  </http_server>
</CONF>
```
To manually inspectaspera.conf, open it from the following directory:

/opt/aspera/etc/aspera.conf
After enabling HTTP fallback and setting a token encryption key, restart asperacentral, asperanoded, and asperahttpd.
Run the following command in a Terminal window to restart asperacentral:
```
# /etc/init.d/asperacentral restart
```
Run the following commands to restart asperanoded:
```
# /etc/init.d/asperanoded restart
```
Run the following commands to restart asperahttpd:
```
# /etc/init.d/asperahttpd restart
```