Difference between revisions of "HowTo: Managing Space Reservation (Tokens)"
Jump to navigation
Jump to search
| Line 1: | Line 1: | ||
| − | = | + | = Introduction = |
| − | + | * In all this document we will refer to the Space Reservation administration. Space Reservation is also known as Token. | |
| + | == Connect to the SrmSpaceManager Admin Console == | ||
a) Using '''pCells''', locate the '''''SrmSpaceManager''''' cell (under the srm-${hostname}Domain). | a) Using '''pCells''', locate the '''''SrmSpaceManager''''' cell (under the srm-${hostname}Domain). | ||
| + | b) Logging to '''dccore.pic.es''' like this: '''''ssh -2 -x -o StrictHostKeyChecking=no -l admin -c blowfish -p 22224 dccore.pic.es''''' | ||
| − | |||
| − | = | + | = Managing the Space Reservation = |
| + | == Create a Space Reservation == | ||
The command to add a space reservation is <tt>'''reserve space'''</tt>. | The command to add a space reservation is <tt>'''reserve space'''</tt>. | ||
| − | reserve space -al=online|nearline [-desc=string] -lg=name [-lifetime=seconds] [-owner=user|fqan] -rp=replica|custodial size | + | '''reserve space -al=online|nearline [-desc=string] -lg=name [-lifetime=seconds] [-owner=user|fqan] -rp=replica|custodial size''' |
| − | :If no '''''lifetime''''' is given, the reservation will never expire | + | :* If no '''''lifetime''''' is given, the reservation will never expire |
| − | :'''''size''''' is defined in bytes, but accepts an optional by suffix using either '''[https://es.wikipedia.org/wiki/IEEE_1541-2002 SI or IEEE 1541]''' prefixes. | + | :* '''''size''''' is defined in bytes, but accepts an optional by suffix using either '''[https://es.wikipedia.org/wiki/IEEE_1541-2002 SI or IEEE 1541]''' prefixes. |
As an example, to add a 4TB disk-only token named '''ATLASTESTDISK''' in the link group '''linkgroup-atlas''' | As an example, to add a 4TB disk-only token named '''ATLASTESTDISK''' in the link group '''linkgroup-atlas''' | ||
| Line 19: | Line 21: | ||
reserve space -al=online -rp=replica -lg=linkgroup-atlas -owner=/atlas -desc=ATLASTESTDISK 4000000000000 | reserve space -al=online -rp=replica -lg=linkgroup-atlas -owner=/atlas -desc=ATLASTESTDISK 4000000000000 | ||
| − | = | + | == Update a Space Reservation == |
| − | + | ||
| − | update space [-desc=string] [-eternal] [-lifetime=long] [-owner=user|fqan] [-size=bytes] spacetoken | + | '''update space [-desc=string] [-eternal] [-lifetime=long] [-owner=user|fqan] [-size=bytes] spacetoken''' |
| − | < | + | |
| + | :'''''size''''' is defined in bytes, but accepts an optional by suffix using either '''[https://es.wikipedia.org/wiki/IEEE_1541-2002 SI or IEEE 1541]''' prefixes. | ||
| + | |||
| + | As an example, to update the space reservation ATLASTESTDISK to '''5TB''' | ||
| + | |||
| + | update space -desc=ATLASTESTDISK -size=5000000000000 <token_id> | ||
| + | |||
| + | :*Is possible that you have several tokens with the very same description. Only one of them should be in state RESERVED, all others should be RELEASED. In case of doubt try to figure out which is the token ID of the token being used (ie: look at the monitoring at dcmon.pic.es). | ||
| − | + | == Release Reservation == | |
| − | + | '''release space token''' | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | == List space reservations == | |
| − | = | + | '''ls spaces [-a] [-al=online|nearline] [-e] [-h] [-l] [-lg=string] [-limit=rows] [-owner=user|fqan] [-rp=replica|custodial] [-state=reserved|released|expired] ... [token|pattern]''' |
| − | + | = Other interesting commands = | |
| − | + | == List link groups == | |
| − | [ | + | '''ls link groups [-a] [-al=online|nearline] [-h] [-l] [-rp=output|replica|custodial] [name]''' |
| − | + | == List File Reservations == | |
| − | + | '''ls files [-a] [-h] [-limit=rows] [-owner=user|fqan] [-p] [-state=transferring|stored|flushed] ... [-token=long] [pnfsid|path]''' | |
| − | |||
| − | ''' | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Revision as of 10:43, 6 August 2015
Introduction
- In all this document we will refer to the Space Reservation administration. Space Reservation is also known as Token.
Connect to the SrmSpaceManager Admin Console
a) Using pCells, locate the SrmSpaceManager cell (under the srm-${hostname}Domain). b) Logging to dccore.pic.es like this: ssh -2 -x -o StrictHostKeyChecking=no -l admin -c blowfish -p 22224 dccore.pic.es
Managing the Space Reservation
Create a Space Reservation
The command to add a space reservation is reserve space.
reserve space -al=online|nearline [-desc=string] -lg=name [-lifetime=seconds] [-owner=user|fqan] -rp=replica|custodial size
- If no lifetime is given, the reservation will never expire
- size is defined in bytes, but accepts an optional by suffix using either SI or IEEE 1541 prefixes.
As an example, to add a 4TB disk-only token named ATLASTESTDISK in the link group linkgroup-atlas
reserve space -al=online -rp=replica -lg=linkgroup-atlas -owner=/atlas -desc=ATLASTESTDISK 4000000000000
Update a Space Reservation
update space [-desc=string] [-eternal] [-lifetime=long] [-owner=user|fqan] [-size=bytes] spacetoken
- size is defined in bytes, but accepts an optional by suffix using either SI or IEEE 1541 prefixes.
As an example, to update the space reservation ATLASTESTDISK to 5TB
update space -desc=ATLASTESTDISK -size=5000000000000 <token_id>
- Is possible that you have several tokens with the very same description. Only one of them should be in state RESERVED, all others should be RELEASED. In case of doubt try to figure out which is the token ID of the token being used (ie: look at the monitoring at dcmon.pic.es).
Release Reservation
release space token
List space reservations
ls spaces [-a] [-al=online|nearline] [-e] [-h] [-l] [-lg=string] [-limit=rows] [-owner=user|fqan] [-rp=replica|custodial] [-state=reserved|released|expired] ... [token|pattern]
Other interesting commands
List link groups
ls link groups [-a] [-al=online|nearline] [-h] [-l] [-rp=output|replica|custodial] [name]
List File Reservations
ls files [-a] [-h] [-limit=rows] [-owner=user|fqan] [-p] [-state=transferring|stored|flushed] ... [-token=long] [pnfsid|path]