The release of the Connect browser client version 3.6.1 enhances usability of Faspex with drag and drop support for Chrome, as well as all other compatible browsers including Firefox, Safari and Internet Explorer.
In order to make use of this new feature on your Faspex web interface you will need to install a patch on your Faspex web server. The patch will also update the minimum version of Connect required of your users on your Faspex server, so that users will be prompted to upgrade to 3.6.1.
The patch requires Faspex 3.9.2. Follow the instructions below for patching Faspex, and if you encounter any difficulties please contact technical support.
Download the patch
You can apply the patch either by installing the patch files manually on your system or by running a script which does this for you.
1. Navigate to your Faspex installation directory:
cd 'C:\Program Files (x86)\Aspera\Faspex\'
2. From the installation directory, run the following command:
3. Back up the following files from the installation directory:
You can backup a file by making a copy of it and appending .bak to it, such as with the following command:
cp /path/to/file.js /path/to/file.js.bak
copy path\to\file.js path\to\file.js.bak
4. Extract the contents of the patch zip file to a temporary directory.
5. Replace the files in step 3 with their corresponding patch files from the temporary directory. You can do this by copying over each of the 8 patch files to their appropriate location.
6. Copy the following remaining patch file from the temporary directory to the /db/migrate directory in the installation directory:
For example, you could use a command like the following:
cp /path/to/tmp/directory/20150821015530_update_default_min_connect_version_to361.rb /opt/aspera/faspex/db/migrate/
copy \path\to\tmp\directory\20150821015530_update_default_min_connect_version_to361.rb ^
'C:\Program Files (x86)\Aspera\Faspex\db\migrate\'
On Linux, change the owner and group of this file to the user faspex:
chown faspex:faspex db/migrate/20150821015530_update_default_min_connect_version_to361.rb
7. (Linux only step) Change the file permissions and ownership of the patch files to match the original files.
8. Run the following commands in the given order from the installation directory:
# asctl faspex:rake db:migrate
# asctl faspex:start
9. You have now patched Faspex to support Connect 3.6.1 and the drag and drop features on all compatible browsers.
You can alternatively apply the patch by running the appropriate script attached at the bottom of this article which accomplishes the above instructions for you.
Download the script for your system. You can then run the script with the following steps:
1. Extract the contents of the patch zip file to a temporary directory. Copy the script file to this directory.
2. Make a backup of the Faspex database:
3. (Linux only step) Give the script file execute permission:
chmod u+x linux_faspex_3.9.2_patchscript.sh
4. Run the script.
On Windows, navigate to the temporary directory containing the patch files and the script. If you are logged in as Administrator you can simply double click the windows_faspex_3.9.2_patchscript.bat file. If you are not, right click the script file and select Run as Administrator.
On Linux, navigate to the temporary directory containing the patch files and the script. From here, run the script:
5. You have now patched Faspex to support Connect 3.6.1 and the drag and drop features on all compatible browsers.
If the script was not successful, please try the manual instructions above or contact Technical Support for further assistance.