Difference between revisions of "HowTo: Managing Space Reservation (Tokens)"

From Public PIC Wiki
Jump to navigation Jump to search
 
(2 intermediate revisions by the same user not shown)
Line 11: Line 11:
 
= Managing the Space Reservation =
 
= Managing the Space Reservation =
 
== Create a 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'''
Line 18: Line 18:
 
:* '''''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'''
  
 
  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
Line 28: Line 28:
 
:'''''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 update the space reservation ATLASTESTDISK to '''5TB'''
+
* As an example, to update the space reservation ATLASTESTDISK to '''5TB'''
  
 
  update space -desc=ATLASTESTDISK -size=5000000000000 <token_id>
 
  update space -desc=ATLASTESTDISK -size=5000000000000 <token_id>
Line 38: Line 38:
 
  '''release space token'''
 
  '''release space token'''
  
== List space reservations ==
+
== 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]'''
 
  '''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 ==
 
 
== List link groups ==
 
  
 
  '''ls link groups [-a] [-al=online|nearline] [-h] [-l] [-rp=output|replica|custodial] [name]'''
 
  '''ls link groups [-a] [-al=online|nearline] [-h] [-l] [-rp=output|replica|custodial] [name]'''

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]