Product Setup

Important: If this is a product upgrade, review all prerequisites described in Before Upgrading.

IBM Aspera Connect Server is a web-based file server that enables file access through a browser, and transfers files using the IBM Aspera Connect Browser Plug-in. Additionally, you can set up HTTP Fallback to establish HTTP- or HTTPS-based file transfers with clients that don't have FASP connectivity.

To install Connect Server, log into your computer with root permissions, and follow the steps below.

  1. Download the IBM Aspera product installer.

    Use the credentials provided to your organization by Aspera to access:
    http://asperasoft.com/en/downloads/4

    If you need help determining your firm's access credentials, contact your Aspera account manager.

  2. For product upgrades, ensure you have prepared your machine to upgrade to a newer version.
    Although the installer performs your upgrade automatically, Aspera highly recommends completing the tasks described in Before Upgrading. If you do not follow these steps, you risk installation errors or losing your configuration settings.
  3. Run the installer
    To run the installer, run the following commands with the proper administrative permissions. Replace the product version accordingly.
    OS Commands
    RedHat, zLinux, CentOS
    $ rpm -Uvh aspera-entsrv-version.rpm 
    Debian
    $ dpkg -i aspera-entsrv-version.deb

    On some CentOS 7 and Fedora systems, you may see the following message in the output of the installation process:

    To complete the Connect Server Installation:
    - Install the Data::Dumper Perl module
    - Install the Digest::MD5 Perl module
    This indicates that the Perl modules Digest::MD5 and/or Data::Dumper are absent, but they are required to complete the Connect Server installation. To prevent this error, or to complete the installation, run the following commands:
    $ sudo yum install perl-Digest-MD5
    $ sudo yum install perl-Data-Dumper
  4. Install the license.
    The license can be installed using the GUI or from the command line.
    • GUI:Launch the application by running the following command as root:
      # asperascp

      If this is a fresh install, an Enter License window appears. Either click Import License File and select the license file, or click Paste License Text to copy-and-paste the license file's content. The license information will appear in the window. Verify that it is correct and click Close.


      The Enter License window.
    • Terminal: Create the following file:
      /opt/aspera/etc/aspera-license

      Copy and paste your license key string into it, then save and close the file. To verify the license information, run the following command:

      $ ascp -A

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

  5. Review or update OpenSSH authentication methods.
    Open your SSH Server configuration file from /etc/ssh/sshd_config with a text editor.

    To allow public key authentication, set PubkeyAuthentication to yes. To allow password authentication, set PasswordAuthentication to yes, for example:

    ...
    PubkeyAuthentication yes
    PasswordAuthentication yes
    ...

    Save the file then run the following to reload SSH:

    RedHat

    $ sudo service sshd restart

    Debian

    $ sudo /etc/init.d/ssh restart

    To further secure your SSH Server, see Securing your SSH Server.

  6. Troubleshooting
    Important: When upgrading from Connect Server versions older than 3.0, system-level security settings are not preserved and must be reconfigured. For instructions on enabling or disabling system-level security, see Configuring Apache.
  7. Set up your new Connect Server's web UI (or verify your web UI settings after an upgrade).
    Your IBM Aspera transfer product is now installed. Additional steps are required to configure the web UI, see Connect Server Web UI Setup.