Product Setup

A walkthrough of the setup process.

Important: If this is a product upgrade, ensure that you have reviewed all prerequisites detailed under the topic "Before Upgrading."

Download the IBM Aspera product installer

Download the installer from the link below. Use the credentials provided to your organization by Aspera to access:

http://asperasoft.com/en/downloads/2

If you need help determining your firm's access credentials, contact Technical Support.
For product upgrades, ensure you have prepared your machine to upgrade to a newer version.

Although the installer for Aspera Client performs your upgrade automatically, Aspera highly recommends completing the tasks identified in the topic Before Upgrading. If you do not follow these steps, you risk installation errors or losing your former configuration settings.

Run the installer

When downloaded, run the installer using the following commands and with the proper administrative permissions. Replace the file name accordingly.

OS	Commands
RedHat	$ rpm -Uvh aspera-scp-client-`version`.rpm
Debian	$ dpkg -i aspera-scp-client-`version`.deb

Install the license

There are two ways to install the license: through the GUI or via command line.

Method	Instructions
GUI	To install the license via the GUI, execute asperascp in a Terminal (as a root user) to launch the application. If this is a fresh install, an Enter License window appears. You may click the Import License File and select the license file, or Paste License Text to copy-and-paste the license file's content. When finished, the license information will appear in the window. Verify that it is correct and click Close.
Terminal	To install the license through command line, create the following file and paste your license key string into it: /opt/aspera/etc/aspera-license When finished, save and close the file. Use this command to verify the license info: `$` ascp -A

Method

Instructions

GUI

To install the license via the GUI, execute asperascp in a Terminal (as a root user) to launch the application. If this is a fresh install, an Enter License window appears. You may click the Import License File and select the license file, or Paste License Text to copy-and-paste the license file's content. When finished, the license information will appear in the window. Verify that it is correct and click Close.
The Enter License window.

Terminal

To install the license through command line, create the following file and paste your license key string into it:

/opt/aspera/etc/aspera-license

When finished, save and close the file. Use this command to verify the license info:

$ ascp -A

If you are updating your product license after the installation, see Updating the Product License.

Convert the old aspera.conf file manually (necessary only when upgrading from product version 2.2 or earlier)
For product versions 2.5+, the docroot settings have been moved to the Aspera configuration file, aspera.conf. When upgrading from product version 2.2 or earlier, the installer converts your old configuration files to the new format, using a "strict" method. If the old aspera.conf file has errors or unrecognized directives, the conversion will fail. To review the errors, run a strict conversion manually. Change aspera.conf's path if it is not in the default location.
```
$ cd /opt/aspera/etc
$ sudo asconfigurator -T -F convert_conf_V1_data ./aspera.conf
```
If an error occurs during the conversion, use the relaxed conversion method:
```
$ cd /opt/aspera/etc
$ sudo asconfigurator -F convert_conf_V1_data ./aspera.conf 
```
(For upgrades) Check aspera.conf for errors
When upgrading your Aspera product to a newer version, it is recommended that you check the aspera.conf configuration file for errors. Run the following command in a terminal window to validate aspera.conf:
```
$ /opt/aspera/bin/asuserdata -v 
```