Group Storage: Difference between revisions
No edit summary |
|||
Line 1: | Line 1: | ||
Page à renommer en "Group Storage" | |||
== | This service provides large storage spaces, possibly shared between multiple Grid'5000 users. Those storage spaces are accessible on Grid'5000 over NFS. | ||
== Using a storage space that was already created == | |||
First you need to request access to the storage space, by contacting the storage space owner. | |||
Once you have been authorized, if you use an image with NFS provided by the Grid'5000 team, autofs will do the job for you. You just have to go to: | |||
<code class="host">node:</code><code class="command">cd /srv/storage/</code><code class="replace">storage_name</code>@<code class="replace">server_address</code> | |||
for example: | |||
<code class="host">node:</code><code class="command">cd /srv/storage/</code><code class="replace">my_storage</code>@<code class="replace">granche-srv1.lille.grid5000.fr</code> | |||
You may want to add a symbolic link to this path for convenience: | |||
<code class="host">node:</code><code class="command">ln -s /srv/storage/</code><code class="replace">my_storage</code>@<code class="replace">granche-srv1.lille.grid5000.fr</code><code class="command"> ~/my_storage</code> | |||
If you do not use an image provided by the Grid'5000 team, you will need to use the [[Storage_Manager|storage API]] to enable access to the storage space. Contact the Grid'5000 team if needed. | |||
== | == Requesting a new storage space == | ||
To request a new | To request a new storage space, please send an email to support-staff@list.grid5000.fr. Please copy/paste the following text and fill all the required information | ||
* Email subject: | * Email subject: | ||
Line 23: | Line 32: | ||
What is your Grid'5000 login ? | What is your Grid'5000 login ? | ||
<...> | <...> | ||
What name do you want for your storage ? (only lowercase letters, numbers and hyphen (-) allowed) | What name do you want for your storage space ? (only lowercase letters, numbers and hyphen (-) allowed) | ||
<...> | <...> | ||
On which site do you want the storage ? You can also specify the server. | On which site do you want the storage space ? You can also specify the server. | ||
<...> | <...> | ||
What is the name of the group you want to be link with this storage space ? (must start by "sto-", only lowercase letters, numbers and hyphen (-) allowed) | What is the name of the group you want to be link with this storage space ? (must start by "sto-", only lowercase letters, numbers and hyphen (-) allowed) | ||
sto-<...> | sto-<...> | ||
Does the group already exists (from another storage | Does the group already exists (from another storage space) ? | ||
Yes/No | Yes/No | ||
What size do you require for the storage? | What size do you require for the storage space? | ||
XXX GBytes/TBytes | XXX GBytes/TBytes | ||
What is the intended usage, in ~5 lines ? | What is the intended usage, in ~5 lines ? | ||
<...> | <...> | ||
What is the expiration date (We will contact you before removing your storage) ? | |||
<...> | <...> | ||
The support staff will create the storage, and if the group is new, will create and set you as an owner of the group. | The support staff will create the storage space, and if the group is new, will create and set you as an owner of the group. | ||
=== Available servers for storage spaces === | |||
{| class="wikitable" | |||
|- | |||
! Site !! Server Name !! Size !! Status !! Notes | |||
|- | |||
| [[Lille:Home|Lille]] || granche-srv1.lille.grid5000.fr || 94TB || [[Image:Check.png]] || | |||
|- | |||
|} | |||
More servers will be added when this service will no longer be in beta. | |||
== Managing the group == | == Managing the group == | ||
For now, the only way to manage the group is | For now, the only way to manage the group is by using the REST API. The documentation can be found at [http://here https://gitlab.inria.fr/grid5000/users-api-ror/blob/master/API.md]. <<- FIXME: Can the git project be public | ||
For a basic usage, you will need to update the list of member of a group, it's is done like so: | For a basic usage, you will need to update the list of member of a group, it's is done like so: | ||
Line 55: | Line 75: | ||
Here, we have removed <code class="replace">pcapaldi</code> and add <code class="replace">jwhittaker</code> | Here, we have removed <code class="replace">pcapaldi</code> and add <code class="replace">jwhittaker</code> | ||
Revision as of 11:09, 6 March 2019
Page à renommer en "Group Storage"
This service provides large storage spaces, possibly shared between multiple Grid'5000 users. Those storage spaces are accessible on Grid'5000 over NFS.
Using a storage space that was already created
First you need to request access to the storage space, by contacting the storage space owner. Once you have been authorized, if you use an image with NFS provided by the Grid'5000 team, autofs will do the job for you. You just have to go to:
node:
cd /srv/storage/
storage_name
@server_address
for example:
node:
cd /srv/storage/
my_storage
@granche-srv1.lille.grid5000.fr
You may want to add a symbolic link to this path for convenience:
node:
ln -s /srv/storage/
my_storage
@granche-srv1.lille.grid5000.fr
~/my_storage
If you do not use an image provided by the Grid'5000 team, you will need to use the storage API to enable access to the storage space. Contact the Grid'5000 team if needed.
Requesting a new storage space
To request a new storage space, please send an email to support-staff@list.grid5000.fr. Please copy/paste the following text and fill all the required information
- Email subject:
Group storage creation
- Email content:
What is your Grid'5000 login ? <...> What name do you want for your storage space ? (only lowercase letters, numbers and hyphen (-) allowed) <...> On which site do you want the storage space ? You can also specify the server. <...> What is the name of the group you want to be link with this storage space ? (must start by "sto-", only lowercase letters, numbers and hyphen (-) allowed) sto-<...> Does the group already exists (from another storage space) ? Yes/No What size do you require for the storage space? XXX GBytes/TBytes What is the intended usage, in ~5 lines ? <...> What is the expiration date (We will contact you before removing your storage) ? <...>
The support staff will create the storage space, and if the group is new, will create and set you as an owner of the group.
Available servers for storage spaces
Site | Server Name | Size | Status | Notes |
---|---|---|---|---|
Lille | granche-srv1.lille.grid5000.fr | 94TB | ![]() |
More servers will be added when this service will no longer be in beta.
Managing the group
For now, the only way to manage the group is by using the REST API. The documentation can be found at https://gitlab.inria.fr/grid5000/users-api-ror/blob/master/API.md. <<- FIXME: Can the git project be public
For a basic usage, you will need to update the list of member of a group, it's is done like so:
- First we get the list of the current user of the group:
frontend:
curl 'https://api.grid5000.fr/stable/users/groups/
sto-mygroup
' | jq .members
[ "dtennant", "msmith", "pcapaldi" ]
- Then we replace by the wanted updated list:
frontend:
curl -X PATCH -H 'Content-Type: application/json' 'https://api.grid5000.fr/stable/users/groups/
sto-mygroup
'-d '{"members": ["
dtennant
", "msmith
", "jwhittaker
"]}'
Here, we have removed pcapaldi
and add jwhittaker