Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
rdms:access:linux:icommands [2026/05/21 12:58] – burcurdms:access:linux:icommands [2026/07/13 11:55] (current) – burcu
Line 1: Line 1:
 ====== iCommands ====== ====== iCommands ======
  
-The complete functionality of the RDMS comes with ''iCommands'' on the command-line interface (CLI).+The full functionality of the RDMS is available via ''iCommands'' in the command-line interface (CLI).
  
   * ''iCommands'' is the official CLI client by iRODS, the open-source software upon which the RDMS is built.   * ''iCommands'' is the official CLI client by iRODS, the open-source software upon which the RDMS is built.
Line 71: Line 71:
 </code>  </code> 
  
-If you do not see an error after specifying your password, you are set to start using ''iCommands''. See the section below for more information on using ''iCommands'' including some examples. +If you do not see an error after specifying your password, you are set to start using ''iCommands''. See the section below for more information on using ''iCommands'', including some examples. 
  
 **Note:**\\ The ''iinit'' command will not just initialize your connection to the RDMS, but will also store your password in an obfuscated format under ''~/.irods/.irodsA''. Therefore, you do not have to retype your password each time a subsequent command is executed during the same session. **Note:**\\ The ''iinit'' command will not just initialize your connection to the RDMS, but will also store your password in an obfuscated format under ''~/.irods/.irodsA''. Therefore, you do not have to retype your password each time a subsequent command is executed during the same session.
 +
 +==== Switching Between Different Zones ====
 +If you have access to more than one iRODS zone, such as the default zone and Sensitive Data (SD) zone, you can configure shell aliases to quickly switch between different iRODS environment files.
 +
 +1. Open your ''~/.bashrc'' file in a text editor.
 +
 +2. Add aliases similar to the following:
 +
 +<code>
 +alias irods-rug='export IRODS_ENVIRONMENT_FILE="$HOME/.irods/irods_environment.json"; echo "Selected iRODS zone: RUG"'
 +alias irods-sd='export IRODS_ENVIRONMENT_FILE="$HOME/.irods/irods_environment_sd.json"; echo "Selected iRODS zone: SD Zone"'
 +</code>
 +
 +3. Save the file and reload your shell configuration:
 +
 +<code>
 +source ~/.bashrc
 +</code>
 +
 +4. Select the iRODS zone you want to use:
 +
 +<code>
 +irods-rug
 +</code>
 +
 +or
 +
 +<code>
 +irods-sd
 +</code>
 +
 +5. Initialize your iRODS session (if required):
 +
 +<code>
 +iinit
 +</code>
 +6. Verify that the correct environment is active:
 +
 +<code>
 +ienv
 +</code>
 +The selected alias sets the ''IRODS_ENVIRONMENT_FILE'' environment variable to the corresponding iRODS environment file. Any subsequent iCommands will use that environment until you switch to another one or open a new terminal session.
  
 ===== Installing iCommands ===== ===== Installing iCommands =====