MesoBox¶

About MesoBox¶

MesoBox is a cloud storage middleware aimed to make storage and application inter-operability through a common plateform.

MesoBox provide a owncloud API that allow using desktop & web's owncloud app. MesoBox is based on reva

Common known issues¶

dir location ¶

When logged in, you are redirect to hierarchy root (/), your personal directory is stored in users/first.name. You can list all users directory even you only can access to your own.

dir deletation ¶

It's not possible to delete a non-empty directory. We have to remove all files inside before removing the directory.

Web base access¶

The web interface of mesobox service use your adonis account.

Web access provide you some basic web base app

file editor: which allow you to edit a raw file
drawio: which allow you to create schema

Web access known issues¶

The sharing plugin is currently NOT working. This is a mesocentre team priority to make it work.

downloading ¶

When downloading a file, you are redirected to reva backend which need a authentication. You have to use your adonis account.

Desktop app access¶

Reva provide a owncloud compatible API, you can use the standard owncloud desktop app to connect to owncloud.

add account¶

On server address page, you have to put https://reva.mesocentre.universite-paris-saclay.fr. This is the owncloud API endpoint for reva service.

service uri

On login page, you have to put your adonis account name. Your login should be without @univeriste-paris-saclay.fr.

login

When finished, a directory will be created on your desktop and synchronized with owncloud API. The default location should be something like ${HOME}/ownCloud - <firstname lastname>@reva.mesocentre.universite-paris-saclay.fr by default.

Of course, you can change it in advanced configuration mode.

done

synchronization customization¶

By default, owncloud app will synchronise all file you have access to, in case of a large project you probably don't want to sync all file. You can easly select file you want to synchronise

dir selection

Rclone¶

Rclone is a command-line program to manage files on cloud storage. You can use it to access your reva storage. You can install it from your package system in Linux or Mac OS X, or download the installer for Windows.

Configuration¶

you can configure rclone with an interactive prompt. First create a reva remote:

% rclone config
2025/01/29 14:42:24 NOTICE: Config file "${HOME}/.config/rclone/rclone.co\
nf" not found - using defaults
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
Enter name for new remote.
name> reva

Then choose the WebDAV storage (55 in the list)

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
 1 / 1Fichier
   \ (fichier)
 2 / Akamai NetStorage
   \ (netstorage)
[...]
55 / WebDAV
   \ (webdav)
Storage> 55

Add Reva url (https://reva.mesocentre.universite-paris-saclay.fr/remote.php/webdav):

Option url.
URL of http host to connect to.
E.g. https://example.com.
Enter a value.
url> https://reva.mesocentre.universite-paris-saclay.fr/remote.php/webdav

Add vendor (3 for Owncloud):

Option vendor.
Name of the WebDAV site/service/software you are using.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Fastmail Files
   \ (fastmail)
 2 / Nextcloud
   \ (nextcloud)
 3 / Owncloud
[...]
vendor> 3

Add your ADONIS username:

Option user.
User name.
In case NTLM authentication is used, the username should be in the format 'Domain\User'.
Enter a value. Press Enter to leave empty.
user> firstname.lastname

And optionnaly, your password, be aware that it will be obscured, but not encrypted. Whoever has access to this config file will be able to use your ADONIS credentials.

Option pass.
Password.
Choose an alternative below. Press Enter for the default (n).
y) Yes, type in my own password
g) Generate random password
n) No, leave this optional password blank (default)
y/g/n> y
Enter the password:
password:
Confirm the password:
password:

Leave empty the option Bearer token. And leave the prompt.

Option bearer_token.
Bearer token instead of user/pass (e.g. a Macaroon).
Enter a value. Press Enter to leave empty.
bearer_token>

Edit advanced config?
y) Yes
n) No (default)
y/n>

Configuration complete.
Options:
- type: webdav
- url: https://reva.mesocentre.universite-paris-saclay.fr/remote.php/webdav
- vendor: owncloud
- user: firstname.lastname
- pass: *** ENCRYPTED ***
Keep this "reva" remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>

Current remotes:

Name                 Type
====                 ====
reva                 webdav

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q

Usage¶

List directory

% rclone lsd reva:
          -1 2024-04-17 12:08:46        -1 .reva_hidden
          -1 2024-04-12 18:43:00        -1 others
          -1 2024-03-26 17:29:22        -1 test
          -1 2025-01-28 18:07:12        -1 users
          -1 2024-04-24 15:12:56        -1 workspace

Make directory

% rclone mkdir reva:users/firstname.lastname/so

Copy a file or directory recursively

rclone copy ~/Downloads/brochure-science-ouverte.pdf reva:users/firstname.lastname/so/

List files and directory recursively

% rclone ls reva:users/firstname.lastname/so/
   737615 brochure-science-ouverte.pdf

Delete files recursively

% rclone delete reva:users/firstname.lastname/so/

Delete dirs recursively

% rclone rmdirs reva:users/firstname.lastname/so/

Beware: you cannot delete all files and dirs recursively. You must first delete files, then directories. if you use the Owncloud client in parallel, wait for the file deletion to be synced before deleting directories, otherwise the Owncloud client might get mixed up.

Please check all rclones commands and their documentation.