If your computer is running Console version 1.4.x or older, the asctl command in the newer common files package will not be able to control or configure Aspera Console. You need to perform the following steps to configure Aspera Console to work along side the new Aspera Faspex.

WARNING: These instructions are for Console version 1.4.x and OLDER. Due to incompatible common components, Aspera Console 1.5.x and Aspera Faspex Server (all versions) should NOT be installed on the same machine. Aspera does not support this combination.

  1. Configure Aspera's installation of Apache

    Open the Aspera common files' Apache configuration file with a text editor:

    OS Version File Location
    32-bit Windows C:\Program Files\Common Files\Aspera\Common\apache\apache.rb.yml
    64-bit Windows C:\Program Files\Common Files (x86)\Aspera\Common\apache\apache.rb.yml

    Based on your operating system, you will need to add the location of Aspera Console's apache conf file to apache.rb.yml so that the two applications can run concurrently.

    OS Version Location of console.apache.conf
    32-bit Windows C:\Program Files\Aspera\Management Console\config\console.apache.conf
    64-bit Windows C:\Program Files (x86)\Aspera\Management Console\config\console.apache.conf

    Add the file location to the "includes" section of apache.rb.yml (along with a hyphen (-) preceding it):

    For 32-bit Windows, the "includes" section will appear as follows:

    ...
    :includes:
    - C:\Program Files\Aspera\Faspex\config\faspex.apache.windows.conf
    - C:\Program Files\Aspera\Management Console\config\console.apache.conf
    :log_level: emerg
    ...
    

    Save the file and execute the following command to regenerate the Apache configuration file and restart it:

    > asctl apache:generate_config
  2. Update Console SMTP server's configuration file (Optional)
    This step is only required when your Console's email server uses "Login required" authentication type.

    Locate the following file and open with a text editor:

    OS Version File Location
    32-bit Windows C:\Program Files\Aspera\Management Console\lib\smtp_tls.rb
    64-bit Windows C:\Program Files (x86)\Aspera\Management Console\lib\smtp_tls.rb

    In this file, locate the following line:

    check_auth_args user, secret, authtype if user or secret 

    Change it to the following:

    check_auth_args user, secret 
  3. Restart Console

    To restart Aspera Console, open a Command Prompt and execute the following command:

    > asctl apache:generate_config

    To restart Aspera Console, go to Control Panel > Administrative Tools > Services and restart the following services:

    • Aspera Console (Mongrels)
    • Aspera Console (Background)
    • Aspera Console (SOAP)
    • Aspera Console (Email)

    IMPORTANT NOTE: Once you upgrade to Faspex 2.0+, you will no longer be able to control Console using the asctl command.

After these configuration steps, Console should now work with the newer common files package.