From e581084030b21dec852d30174d0aece793bd4bcd Mon Sep 17 00:00:00 2001
From: Adam Caprez <acaprez2@unl.edu>
Date: Thu, 1 Jul 2021 18:00:23 +0000
Subject: [PATCH] Add section on using icommands.
---
.../data_transfer/connect_to_cb3_irods.md | 50 +++++++++++++++++++
1 file changed, 50 insertions(+)
diff --git a/content/handling_data/data_transfer/connect_to_cb3_irods.md b/content/handling_data/data_transfer/connect_to_cb3_irods.md
index 1431f687..0b7eac03 100644
--- a/content/handling_data/data_transfer/connect_to_cb3_irods.md
+++ b/content/handling_data/data_transfer/connect_to_cb3_irods.md
@@ -44,3 +44,53 @@ data transfers should use CyberDuck instead.
6. After logging in, a new explorer window will appear and you will be in your personal directory. You can transfer files or directories by dragging and dropping them to or from your local machine into the window.
{{< figure src="/images/30442927.png" class="img-border" height="450" >}}
+
+### Using the iRODS CLI tools from Crane/Rhino
+
+The iRODS icommand tools are available on Crane and Rhino to use for data transfer to/from the clusters.
+They first require creating a small json configuration file. Create a directory named `~/.irods` first by running
+
+{{< highlight bash >}}
+$ mkdir -p ~/.irods
+{{< /highlight >}}
+
+Next, save the following JSON snippet in a file called `~/.irods/irods_environment.json`:
+
+{{% panel header="`irods_environment.json`"%}}
+{{< highlight json >}}
+{
+ "irods_host": "cb3-irodsmain.unl.edu",
+ "irods_port": 1247,
+ "irods_user_name": "<USERNAME>",
+ "irods_zone_name": "CB3",
+ "irods_encryption_key_size": 32,
+ "irods_encryption_num_hash_rounds": 16,
+ "irods_encryption_salt_size": 8,
+ "irods_client_server_policy": "CS_NEG_REQUIRE",
+ "irods_authentication_scheme": "PAM"
+}
+{{< /highlight >}}
+{{% /panel %}}
+
+Be sure to **replace the \<USERNAME\> placeholder with your UNL username**.
+
+Load the irods module and run the `iinit` command to login to iRODS, entering your **UNL password** when prompted:
+
+{{< highlight bash >}}
+$ module load irods
+$ iinit
+Enter your current PAM password:
+{{< /highlight >}}
+
+If no errors are printed then the login was successful. Run the `ils` command as a test. You should see the contents of your
+iRODS home folder.
+
+{{< highlight bash >}}
+$ ils
+/CB3/home/USERNAME:
+ myfile1
+ myfile2
+{{< /highlight >}}
+
+You can now use the iRODS transfer commands such as `iget`, `iput`, `irsync`, etc. to transfer data. A full list of the
+iRODS user commands is listed [here](https://docs.irods.org/master/icommands/user/).
--
GitLab