diff --git a/docs.it4i/dice.md b/docs.it4i/dice.md index d93c89f2b8921b0349f1e5263149fc86c6d7923b..5fa3e7b90cd78d73da6d9b4094be460ab8cf6f7b 100644 --- a/docs.it4i/dice.md +++ b/docs.it4i/dice.md @@ -19,19 +19,20 @@ The integrated Rule-Oriented Data System (iRODS) is an open source data manageme We have to be sure about your identity, this will be done throught this steps: - sign to MyAccessId [https://ds.myaccessid.org/][g] , 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/#/][f] throught your B2Access account +- after successfull login to B2Access, please sign in to our AAI at : [https://aai.it4i.cz/realms/IT4i_AAI/account/#/][f] throught your B2Access account. You can set new password. this new password will work for cyberduck and icommands. - fill this request for eudat [https://www.eudat.eu/contact-support-request?Service=B2SAFE][h] - finally, contact our support@it4i.cz by crypted mail, we will create account at our iRods server and send you crypted mail.   + ### You Need a 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 - for windows / mac, GUI . Password from aai.it4i.cz (keycloak) works +- iCommands - for linux, cli . Password from aai.it4i.cz (keycloak) works +- Fuse (irodsfs lite) - for linux, cli . Only local password created by support@it4i.cz works for now, we working on it. #### Cyberduck @@ -41,57 +42,10 @@ We have to be sure about your identity, this will be done throught this steps:  -#### Fuse +#### iCommands -- 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: - -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 linux client only, basic knowledge of command line is neccessary -- we tested it on centos7 +- this is linux client only, basic knowledge of commandline is neccessary +- we've tested it on centos7 - for ubuntu20 - there is [http://docs.snic.se/wiki/IRODS_iCommands_installation_on_Ubuntu_20.04#Authenticate_and_test_iRODS_iCommands_client][j] ```console @@ -105,21 +59,27 @@ mkdir ~/.irods/ Copy&paste + edit irods_user_name ```console -[root@icommands ~]# cat .irods/irods_environment.json +$ cat .irods/irods_environment.json { - "irods_host": "irods.it4i.cz", + "irods_host": "irods1.it4i.cz", "irods_port": 1247, + "irods_user_name": "some_user", "irods_zone_name": "IT4I", - "irods_user_name": "b2access_username", "irods_authentication_scheme": "PAM", - "irods_ssl_verify_server": "cert" + "irods_ssl_verify_server": "cert", + "irods_ssl_ca_certificate_file": "/etc/ssl/certs/irods1.it4i.cz.crt", + "irods_encryption_algorithm": "AES-256-CBC", + "irods_encryption_key_size": 32, + "irods_encryption_num_hash_rounds": 16, + "irods_encryption_salt_size": 8 } ``` ```console -[root@icommand .irods]# pwd +$ pwd /root/.irods -[root@icommand .irods]# ls -la + +$ ls -la total 16 drwx------. 2 root root 136 Sep 29 08:53 . dr-xr-x---. 6 root root 206 Sep 29 08:53 .. @@ -131,16 +91,11 @@ dr-xr-x---. 6 root root 206 Sep 29 08:53 .. **step 1:** ```console -[root@icommand .irods]# iinit -``` - -**step 2:** - -```console -[root@irods-client .irods]# iinit +$ iinit Enter your current PAM password: -[root@irods-client .irods]# ils -/IT4I/home/dvo0012: + +$ ils +/IT4I/home/some_user: file.jpg file2.png file3.test @@ -148,6 +103,52 @@ Enter your current PAM password: file5.xlsx ``` +#### Irodsfs Lite + +- work with your irods collection like ordinary directory + +```console +wget https://github.com/cyverse/irodsfs/releases/download/v0.7.3/irodsfs_amd64_linux_v0.7.3.tar +tar -xvf irodsfs_amd64_linux_v0.7.3.tar +mkdir /mount/irods +``` + +settings: + +```console +vim config.yml + +host: irods1.it4i.cz +port: 1247 +proxy_user: some_user +client_user: some_user +zone: IT4I + +path_mappings: + - irods_path: /IT4I/home/some_user + mapping_path: / + resource_type: dir +``` + +How to start - mount your collection: + +```console +./irodsfs -config ~/config.yml ~/mount/irods + +time="2022-07-13 14:42:18.088338" level=info msg="Logging to /tmp/irodsfs_cb7brah44s3cedmmstp0.log" function=processArguments package=main +Password: ##type your password here + +ls -la /mount/irods/ +total 0 +-rwx------ 1 some_user some_user 1073741824 Nov 4 2021 test1G.txt +``` + +How to stop - unmout your collection: + +```console +fusermount -u /mount/irods +``` + For more commands, use the `ihelp` command. [1]: irods.cyberduckprofile diff --git a/docs.it4i/img/aai3-passwd.jpg b/docs.it4i/img/aai3-passwd.jpg new file mode 100644 index 0000000000000000000000000000000000000000..60d4dc14697fdf99a398133996e3f4369037c6d4 Binary files /dev/null and b/docs.it4i/img/aai3-passwd.jpg differ