Before Upgrading

Steps to take before upgrading your Aspera product.

Warning: When upgrading from Connect Server versions older than 3.2.1, the Connect Server system-level security settings are not preserved and must be reconfigured. For instructions on enabling or disabling Connect Server system-level security, see "Configuring Apache" (second-to-last step).

The installer for Aspera Connect Server automatically checks for a previous version of the product on your system. If a previous version is found, the installer automatically removes it and upgrades your computer to the newer version.

Although the installer performs your upgrade automatically, we highly recommend completing the tasks below before starting the installation/upgrade process. If you do not follow these steps, you risk installation errors or losing your former configuration settings. Skip any steps that do not apply to your specific product version.

Note: You cannot upgrade directly between different Aspera transfer products (such as from Point-to-Point to Client, or from Point-to-Point to Enterprise Server). To upgrade, you need to back up the configuration, uninstall the product, and perform a fresh install of the new version of the product. .

All Versions - Verify existing product version
Depending on your current product version, the upgrade preparation procedure may differ. In a Terminal window, execute this command:
```
$ ascp -A
```
This displays the product name and version number.
All versions - Stop all fasp transfer-related applications and connections.
Before upgrading the application, close the following applications and services:
- ascp connections
- SSH connections
- The Connect Server application

All versions - Back up the files

Depending on the version of your previous installation, back up the files in the specified locations:

Version	Folder
2.0.2 to 2.7+	`/opt/aspera/etc/`(Server config, web config, user settings, license info) `/opt/aspera/var/`(Pre- and Post-Processing scripts, Connect Server)
2.0.1 and earlier	`/var/opt/aspera/etc/`(Server config, web config, user settings, license info) `/usr/local/aspera/var/`(Pre- and Post-Processing scripts, Connect Server)

If a previous version of Connect Server (Aspera Web) was set up and customized on your computer, back up the customized Connect Server installation in the following location and use it as a template to modify the new one:

/opt/aspera/var/webtools/

Version 2.1.x - Verify Aspera's configuration file (aspera.conf) version
If you are upgrading from Connect Server version 2.1.x and have HTTP Fallback configured, you may need to modify aspera.conf file to avoid upgrading errors. Open aspera.conf with a text editor:
```
/opt/aspera/etc/aspera.conf
```
Remove the version="2" from the opening tag <CONF>:
```
<CONF version="2">
...
```
Version 2.0.1 and earlier - Back up and restore Web UI authentication info
If the existing installation is version 2.0.1 and prior, you may need to restore the Connect Server's authentication info after the installation. Back up this file:
```
/var/opt/aspera/webpasswd
```
After the upgrade, restore the file to the following directory:
```
/opt/aspera/etc/
```