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.
-
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
-
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
-
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
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.