dice.md

# What Is DICE Project?

DICE (Developing Innovation and Creativity in Education) is an international project co-funded by the Erasmus+ Programme of the European Union.

Its main goals are related to fostering innovation and creativity in education.

This project attempts to be a leading initiative that supports educational community to make progress in the field of innovation and creativity through effective, authentic, practical, sustainable actions.
This project has been funded with support from the European Commission.
For more information, see [http://www.diceproject.eu/][b].

**IT4Innovations participates in DICE. DICE uses the iRods software**

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].

## How to Put Your Data to Our Server

**Prerequisities:**

We have to be sure about your identity, this will be done throught this steps:

- at the first, fill this request for eudat [https://www.eudat.eu/contact-support-request?Service=B2SAFE][h]
- 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. You can set new password. this new password will work for cyberduck and icommands.
- finally, contact our support@it4i.cz by crypted mail, we will create account at our iRods server and send you crypted mail.

![](img/aai.jpg)
![](img/aai2.jpg)
![](img/aai3-passwd.jpg)

### You Need a Client to Connect to iRods Server

- there are many iRods clients, but we recommend theese:
- 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

- download at [https://cyberduck.io/download/][i]
- download connection profile for IT4I irods server [irods.cyberduckprofile][1]
- left doubleclick at this profile file opens connection

![](img/irods-cyberduck.jpg)

#### iCommands

- 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
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
sudo yum install epel-release -y
sudo yum install irods-icommands
mkdir ~/.irods/
```

Copy&paste + edit irods_user_name

```console
$ cat .irods/irods_environment.json
{
    "irods_host": "irods1.it4i.cz",
    "irods_port": 1247,
    "irods_user_name": "some_user",
    "irods_zone_name": "IT4I",
    "irods_authentication_scheme": "PAM",
    "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
$ pwd
/root/.irods

$ ls -la
total 16
drwx------. 2 root root 136 Sep 29 08:53 .
dr-xr-x---. 6 root root 206 Sep 29 08:53 ..
-rw-r--r--. 1 root root 253 Sep 29 08:14 irods_environment.json
```

 **How to Start:**

**step 1:**

```console
$ iinit
Enter your current PAM password:

$ ils
/IT4I/home/some_user:
  file.jpg
  file2.png
  file3.test
  file4.txt
  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

[b]: http://www.diceproject.eu/
[c]: https://irods.org/
[d]: https://b2access.eudat.eu/
[f]: https://aai.it4i.cz/realms/IT4i_AAI/account/#/
[g]: https://ds.myaccessid.org/
[h]: https://www.eudat.eu/contact-support-request?Service=B2SAFE
[i]: https://cyberduck.io/download/
[j]: http://docs.snic.se/wiki/IRODS_iCommands_installation_on_Ubuntu_20.04#Authenticate_and_test_iRODS_iCommands_client