-
Notifications
You must be signed in to change notification settings - Fork 28
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #325 from hpcleuven/feature/update_icommands_insta…
…llation Update iCommands installation instructions to 4.3
- Loading branch information
Showing
1 changed file
with
106 additions
and
37 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -8,7 +8,7 @@ There are more than 50 iCommands. A regular user however may use only a few of t | |
|
|
||
| All iCommands accept standard common line options (e.g., -a for all, -h for help) that gives more capabilities to the commands. To see a subset of these options and to know the details of any iCommand, you can follow the below specified options: | ||
|
|
||
| - You can visit the `iCommands documentation <https://docs.irods.org/4.2.6/icommands/user/>`__ | ||
| - You can visit the `iCommands documentation <https://docs.irods.org/4.2.11/icommands/user/>`__ | ||
|
|
||
| - You can use the ``–h`` option with the command (e.g., ``iput –h``) | ||
|
|
||
|
|
@@ -22,49 +22,118 @@ Installing iCommands locally | |
| ---------------------------- | ||
| iCommands is installed on the KU Leuven Tier-1 and some of the Tier-2 clusters. As it is a client to any iRODS system, it can also be used from any local computer after installing it there. | ||
|
|
||
| On a Linux OS you can use a package manager to install iCommands in the terminal. For the time being, you should install version 4.2.11. Instructions for configuring via the appropriate package manager can be found at the link https://packages.irods.org/. | ||
| On a Linux OS you can use a package manager to install iCommands in the terminal. Instructions for configuring via the appropriate package manager can be found at the link https://packages.irods.org/. | ||
| You can install iCommands on different distributions as follows: | ||
|
|
||
| For CentOS: | ||
| :: | ||
| # Add the iRODS repository to your package manager (if you haven't done so already) | ||
| sudo rpm --import https://packages.irods.org/irods-signing-key.asc | ||
| wget -qO - https://packages.irods.org/renci-irods.yum.repo | sudo tee /etc/yum.repos.d/renci-irods.yum.repo | ||
| Centos 7: | ||
|
|
||
| #Installing iCommands | ||
| sudo yum install irods-icommands-4.2.11 | ||
| .. code:: sh | ||
| For Ubuntu: | ||
| :: | ||
| # Add the iRODS repository to your package manager (if you haven't done so already) | ||
| # If you are on Ubuntu 20, replace '$(lsb_release -sc)' with 'bionic' in the code below: | ||
|
|
||
| wget -qO - https://packages.irods.org/irods-signing-key.asc | sudo apt-key add - | ||
| echo "deb [arch=amd64] https://packages.irods.org/apt/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/renci-irods.list | ||
| sudo apt-get update | ||
|
|
||
| # Install prerequisites (needed for more recent ubuntu versions) | ||
| wget -c \ | ||
| http://security.ubuntu.com/ubuntu/pool/main/p/python-urllib3/python-urllib3_1.22-1ubuntu0.18.04.2_all.deb \ | ||
| http://security.ubuntu.com/ubuntu/pool/main/r/requests/python-requests_2.18.4-2ubuntu0.1_all.deb \ | ||
| http://security.ubuntu.com/ubuntu/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5.10_amd64.deb | ||
| sudo apt install -y \ | ||
| ./python-urllib3_1.22-1ubuntu0.18.04.2_all.deb \ | ||
| ./python-requests_2.18.4-2ubuntu0.1_all.deb \ | ||
| ./libssl1.0.0_1.0.2n-1ubuntu5.10_amd64.deb | ||
| rm -rf \ | ||
| ./python-urllib3_1.22-1ubuntu0.18.04.2_all.deb \ | ||
| ./python-requests_2.18.4-2ubuntu0.1_all.deb \ | ||
| ./libssl1.0.0_1.0.2n-1ubuntu5.10_amd64.deb | ||
|
|
||
|
|
||
| # Install iCommands | ||
| apt-get install irods-runtime=4.2.11-1~bionic | ||
| apt-get install irods-icommands=4.2.11-1~bionic | ||
| # Installing prerequisites | ||
| yum update | ||
| yum install wget sudo | ||
| # Add the iRODS repository to your package manager (if you haven't done so already) | ||
| sudo rpm --import https://packages.irods.org/irods-signing-key.asc | ||
| wget -qO - https://packages.irods.org/renci-irods.yum.repo | sudo tee /etc/yum.repos.d/renci-irods.yum.repo | ||
| # Installing iCommands | ||
| yum install irods-icommands | ||
| Almalinux 8/Rocky Linux 8: | ||
|
|
||
| .. code:: sh | ||
| # Installing prerequisites | ||
| yum update | ||
| yum install wget sudo | ||
| # Add the iRODS repository to your package manager (if you haven't done so already) | ||
| sudo rpm --import https://packages.irods.org/irods-signing-key.asc | ||
| wget -qO - https://packages.irods.org/renci-irods.yum.repo | sudo tee /etc/yum.repos.d/renci-irods.yum.repo | ||
| # irods runtime needs to be installed manually because of https://github.com/k3s-io/k3s/issues/5588 | ||
| yum install irods-runtime | ||
| # Installing iCommands | ||
| yum install irods-icommands | ||
| Debian 11: | ||
|
|
||
| .. code:: sh | ||
| # Installing prerequisites | ||
| apt-get update | ||
| apt-get install wget lsb-release sudo gnupg | ||
| # Add the iRODS repository to your package manager (if you haven't done so already) | ||
| wget -qO - https://packages.irods.org/irods-signing-key.asc | sudo apt-key add - | ||
| echo "deb [arch=amd64] https://packages.irods.org/apt/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/renci-irods.list | ||
| sudo apt-get update | ||
| # Installing iCommands | ||
| apt-get install irods-icommands | ||
| Ubuntu 18/20: | ||
|
|
||
| .. code:: sh | ||
| # Installing prerequisites | ||
| apt-get update | ||
| apt-get install wget lsb-core sudo | ||
| # Add the iRODS repository to your package manager (if you haven't done so already) | ||
| wget -qO - https://packages.irods.org/irods-signing-key.asc | sudo apt-key add - | ||
| echo "deb [arch=amd64] https://packages.irods.org/apt/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/renci-irods.list | ||
| sudo apt-get update | ||
| # Installing iCommands | ||
| apt-get install irods-icommands | ||
| Ubuntu 22: | ||
|
|
||
| .. code:: sh | ||
| # Installing prerequisites | ||
| apt-get update | ||
| apt-get install gnupg wget sudo | ||
| wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb | ||
| sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb | ||
| # Add the iRODS repository to your package manager (if you haven't done so already) | ||
| wget -qO - https://packages.irods.org/irods-signing-key.asc | sudo apt-key add - | ||
| echo "deb [arch=amd64] https://packages.irods.org/apt/ focal main" | sudo tee /etc/apt/sources.list.d/renci-irods.list | ||
| sudo apt-get update | ||
| # Installing iCommands | ||
| apt-get install irods-icommands | ||
| .. note:: | ||
| Depending on your linux distribution and version, the installation procedure may vary. | ||
| For any further assistance, please contact [email protected]. | ||
| If you are running a different Linux distribution, please contact [email protected]. | ||
|
|
||
|
|
||
|
|
||
| Authenticating | ||
| -------------- | ||
|
|
||
| On the Tier-2 systems of KU Leuven, you can authenticate as follows: | ||
|
|
||
| .. code:: sh | ||
| irods-setup | bash | ||
| On the login nodes of other Tier-1 or Tier-2 systems of the VSC on which iCommands are installed, you can use: | ||
|
|
||
| .. code:: sh | ||
| ssh login.hpc.kuleuven.be irods-setup | bash | ||
| Of course, you can also authenticate on a local machine. | ||
| To do so, go to the `ManGO portal <https://mango.vscentrum.be>`__ | ||
| and log in. Click on ‘How to connect’ next to your zone, copy the code | ||
| under ‘iCommands for Linux’ and paste it into your terminal. This should | ||
| authenticate your for 168 hours. | ||
|
|
||
|
|
||
| Informative iRODS Commands | ||
|
|
||