How to patch Faspex for Connect 3.6.1

Note: Faspex 3.9.3 does not require a patch for Connect 3.6.1 and is now available for Windows and Linux. We recommend upgrading rather than patching your 3.9.2 installation.

Description

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.

Environment

• Product: Faspex
• Version: 3.9.2
• Operating System: Linux, Windows

Instructions

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.

Manual installation

1. Navigate to your Faspex installation directory:

Linuxcd /opt/aspera/faspexWindowscd 'C:\Program Files (x86)\Aspera\Faspex\'

2. From the installation directory, run the following command:

asctl faspex:stop

3. Back up the following files from the installation directory:

• app/views/layouts/external_user.html.erb
• app/views/layouts/default.html.erb
• app/views/send/form/misc/_connect_transfer.html.erb
• public/javascripts/connect_auto_install.js
• public/javascripts/send/form/misc/connect_transfer.js
• public/javascripts/utils.js
• public/stylesheets/faspex.css

You can backup a file by making a copy of it and appending .bak to it, such as with the following command:

Linuxcp /path/to/file.js /path/to/file.js.bakWindowscopy 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:

• 20150821015530_update_default_min_connect_version_to361.rb

For example, you could use a command like the following:

Linuxcp /path/to/tmp/directory/20150821015530_update_default_min_connect_version_to361.rb /opt/aspera/faspex/db/migrate/Windowscopy \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

Note: 20150821015530_update_default_min_connect_version_to361.rb should be the ONLY file copied into the /db/migrate directory.

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.

Script installation

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.

Note: Do not run these scripts on an HA system. Please use the manual instructions above.

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:

asctl faspex:backup_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:

./linux_faspex_3.9.2_patchscript.sh

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.

Attachments