diff --git a/docs.it4i/dice.md b/docs.it4i/dice.md index c37d68700f3d572da8d34f86174e68cd77aef455..1bcc51e335e7bffe09b928aedf71eb0e26b8ac16 100644 --- a/docs.it4i/dice.md +++ b/docs.it4i/dice.md @@ -12,18 +12,78 @@ For more information, see [http://www.diceproject.eu/][b]. The integrated Rule-Oriented Data System (iRODS) is an open source data management software used by research organizations and government agencies worldwide. iRODS is released as a production-level distribution aimed at deployment in mission critical environments. It virtualizes data storage resources, so users can take control of their data, regardless of where and on what device the data is stored. As data volumes grow and data services become more complex, iRODS is serving an increasingly important role in data management, see [https://irods.org/][c]. -## iRods Client - -The iRods client is what you - the user - need to install on your system. +## How to put your data to our server **Prerequisities:** -- MyAccessId > B2Access identity [https://b2access.eudat.eu/][d] -- we tested client installation on Centos 7 -- it runs in terminal, basic knowledge is essential +We have to be sure about your identity, this will be done throught this steps: +- sign to MyAccessId https://ds.myaccessid.org/ , after that, please create account at B2Access [https://b2access.eudat.eu/][d] +- after successfull login to B2Access, please sign in to our AAI at : [https://aai.it4i.cz/realms/IT4i_AAI/account/#/] throught your B2Access account +- fill this request for eudat https://www.eudat.eu/contact-support-request?Service=B2SAFE +- finally, contact our support@it4i.cz by crypted mail, we will create account at our iRods server and send you crypted mail. + + + +### You need some client to connect to iRods server + +- there are many iRods clients, but we recommend theese: +- Cyberduck - for windows / mac, GUI +- iCommands - for linux, cli +- Fuse - for linux, cli + + +#### Cyberduck + +- download at https://cyberduck.io/download/ +- download connection profile for IT4I irods server [irods.cyberduckprofile][1] +- left doubleclick at this profile file opens connection + + + +#### Fuse + +- Instalation without openid: +```console +lup005@ubuntu20:~$ wget https://github.com/cyverse/irodsfs/releases/download/v0.7.3/irodsfs_amd64_linux_v0.7.3.tar +lup005@ubuntu20:~$ tar -xvf irodsfs_amd64_linux_v0.7.3.tar +lup005@ubuntu20:~$ mkdir IRODS +``` +settings: +```console +lup005@ubuntu20:~$ vim config.yml + +host: irods1.it4i.cz +port: 1247 +client_user: test +zone: IT4I +password: TestUser123/ + +path_mappings: + - irods_path: /IT4I/home/test + mapping_path: / + resource_type: dir +``` +How to start - mount your collection: +```console +lup005@ubuntu20:~$ ./irodsfs -config ~/config.yml ~/IRODS + +time="2022-07-13 14:42:18.088338" level=info msg="Logging to /tmp/irodsfs_cb7brah44s3cedmmstp0.log" function=processArguments package=main +Username: test +verification: -### Installation of Client to Your Local or VM +lup005@ubuntu20:~$ ls -la IRODS/ +total 0 +-rwx------ 1 lup005 lup005 1073741824 Nov 4 2021 test1G.txt +``` +How to stop - unmout your collection: +```console +lup005@ubuntu20:~$ umount ~/IRODS +``` +#### iCommand + +- this is only linux client, basic knowledge of command line is neccessary +- we tested it on centos7 a ubuntu20 ```console wget 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 @@ -82,7 +142,7 @@ Click the `Log in with B2ACCESS` authorization and continue authentication flow. You have to see this output `Successfully authenticated user. The browser tab can be safely closed.` in the browser. Current problem: after validating the authorization token, it becomes passed and any new command, such as `ils` creates new authorization at keycloak. - +[1]: irods.cyberduckprofile [b]: http://www.diceproject.eu/ [c]: https://irods.org/ [d]: https://b2access.eudat.eu/ diff --git a/docs.it4i/img/aai.jpg b/docs.it4i/img/aai.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0268b3f4a359ec6ff59bb92d1167a631d30730a8 Binary files /dev/null and b/docs.it4i/img/aai.jpg differ diff --git a/docs.it4i/img/aai2.jpg b/docs.it4i/img/aai2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cc589d6619a98385afe53ff5adba3c65367033de Binary files /dev/null and b/docs.it4i/img/aai2.jpg differ diff --git a/docs.it4i/img/irods-cyberduck.jpg b/docs.it4i/img/irods-cyberduck.jpg new file mode 100644 index 0000000000000000000000000000000000000000..1bad0a36981991bc12e2dac8e42351baf1314b2e Binary files /dev/null and b/docs.it4i/img/irods-cyberduck.jpg differ diff --git a/docs.it4i/irods.cyberduckprofile b/docs.it4i/irods.cyberduckprofile new file mode 100644 index 0000000000000000000000000000000000000000..93c44e5bc9ba5029f8ef661d76f8ee6e9518f422 --- /dev/null +++ b/docs.it4i/irods.cyberduckprofile @@ -0,0 +1,39 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ~ Copyright (c) 2002-2017 iterate GmbH. All rights reserved. + ~ https://cyberduck.io/ + ~ + ~ This program is free software; you can redistribute it and/or modify + ~ it under the terms of the GNU General Public License as published by + ~ the Free Software Foundation; either version 2 of the License, or + ~ (at your option) any later version. + ~ + ~ This program is distributed in the hope that it will be useful, + ~ but WITHOUT ANY WARRANTY; without even the implied warranty of + ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + ~ GNU General Public License for more details. + --> + +<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> +<plist version="1.0"> + <dict> + <key>Protocol</key> + <string>irods</string> + <key>Vendor</key> + <string>it4i</string> + <key>Description</key> + <string>it4iInnovations - VSB - TU Ostrava</string> + <key>Hostname Configurable</key> + <false/> + <key>Port Configurable</key> + <false/> + <key>Default Hostname</key> + <string>irods.it4i.cz</string> + <key>Region</key> + <string>IT4I:it4iResc</string> + <key>Default Port</key> + <string>1247</string> + <key>Authorization</key> + <string>PAM</string> + </dict> +</plist>