iBridges GUI#

This notebook shows how to download files and directories from the UNLOCK FAIR Data Platform using iBridges. It focuses on demonstrating usage of the Graphical User Interface (GUI).

iBridges GUI documentation:
https://ibridges-for-irods.github.io/iBridges-GUI

GitHub repository:
iBridges-for-iRODS/iBridges-GUI

The iBridges Graphical User Interface is the most user-friendly and intuitive way to interact with your UNLOCK FDP storage in a fairly powerful manner. It is available for most operating systems (Windows, Mac, and Linux).

Installation#

To install the iBridges GUI, you can download a binary file from:

(NOTE, this still an experimental feature, and not generally recommended)
iBridges-for-iRODS/iBridges-GUI

Alternatively, install the GUI through pip:

Make sure Python version 3.8+ is installed. If you are unfamiliar with Python, install Anaconda.

You can then install iBridges using pip in a terminal:

%pip install ibridges

Then, install the iBridges GUI:

%pip install ibridgesgui

Now, run the iBridges GUI from the command line using the command ibridges-gui.

Authentication#

iBridges (like all iRODS clients) requires a configuration file, which ensures that your connection is encrypted and that you do not need to provide all access information each time you connect to the UNLOCK FDP. This file is typically stored in your home directory under a folder called .irods:

OS

Path to .irods folder

Windows

C:\Users\<your-username>\.irods

macOS

/Users/<your-username>/.irods

Linux

/home/<your-username>/.irods

To create the configuration file, click on Configure, and then Add configuration. In the drop-down menu you can find existing iRODS configuration files, which can be checked and edited in this window. Click New Config and edit the fields accordingly:

  • “irods_authentication_scheme”: “pam_password”

  • “irods_default_resource”: “hot_1”

  • “irods_home”: “/”

  • “irods_host”: “data.m-unlock.nl”

  • “irods_user_name”: “<FILL_IN_YOUR_SRAM_USERNAME_HERE>”,

  • “irods_zone_name”: “unlock”

Use the Check button to validate your configuration file. If your configuration file is not correct the program will guide you to add the required fields. Once all checks have passed, save your environment file.

Connection#

Click Connect, then Connect to iRODS and fill in your SRAM token.

The iBridges GUI supports three main functionalities:

  • browse through storage collections

  • upload, download, or synchronize data

  • manipulate metadata and permissions

iBridges gui

Apart from the Browser tab for permission, data and metadata manipulation, there is a dual-pane Synchronise Data tab, as well as a Search, Info, and Logs tab. When searching data, (a selection of) results can be downloaded. The usage of the iBridges GUI should be relatively straightforward, but if anything remains unclear, refer to the user documentation:
https://ibridges-for-irods.github.io/iBridges-GUI/docs/userdoc.html