Getting started with iBridges-Gui

Install iBridges-gui

pip install ibridgesgui

Start the program

Please start iBridges-Gui by typing ibridges-gui on your terminal and hit enter.

Configuring iBridges-Gui

To connect to the server you need a configuration file, a so-called irods_environment.json. You can create one for yourself using templates, editing default settings we provide for you or simply create such a file.

Installing iRODS server templates

We have created a plugin system to automatically create the environment file for you. Please follow the documentation how to set it up.

Creating an iRODS configuration file

When you start iBridges you will find in the upper drop-down menu Connect and Configure.

Let us check or create a valid configuration file; Click on Configure -> Add Configuration.

Existing configuration files

In the drop-down menu you will find previously created iRODS environments, they start with irods_environment and end with .json. Select the one you want to check.

Creating a configuration from a template

If you do not have an iRODS configuration yet, and you installed a plugin (see above) you can select a configuration template from the drop-down menu. You will have to add your username and save as irods_environment.json.

Creating a new configuration

To create a new environment click on the button New Config. You should see now something like:

Click the Check button to find out whether you can make a connection to the iRODS server. If you get error messages, adjust the contents accordingly. If you are unsure, please contact your iRODS service provider.

Once the check runs through fine click the Save or Save as button. This will store the adjusted configuration in the correct directory on your laptop so that we can use it for the login (See Section below).

Start an iRODS session

To start working with data in iRODS select Connect -> Connect to iRODS. This will open the pop-up window

Select the file we edited above from the drop-down menu and provide your password. If you already logged into iRODS with this or another iRODS client your password might still be cached. This is indicated by the ******. Hit <Enter> or press the Connect button.