Difference between revisions of "HowTo: Managing Space Reservation (Tokens)"
Jump to navigation
Jump to search
(6 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | = | + | = Introduction = |
− | + | * In all this document we will refer to the Space Reservation administration. Space Reservation is also known as Token. | |
− | a) Using '''pCells''', locate the '''''SrmSpaceManager''''' cell (under the srm-${hostname}Domain). | + | == Connect to the SrmSpaceManager Admin Console == |
+ | * Two options: | ||
+ | :'''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 = |
− | The command to add a space reservation is <tt>reserve space</tt>. | + | == Create a Space Reservation == |
+ | * The command to add a space reservation is <tt>'''reserve space'''</tt>. | ||
− | reserve space -al=online|nearline - | + | '''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. | ||
− | 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''' |
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''' | |
− | + | :'''''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]''' |
− | + | ||
− | + | == 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]''' |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 10:45, 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
- Two options:
- 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]
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]