HowTo: Managing Space Reservation (Tokens) - Revision history

Mcaubet at 10:45, 6 August 2015

2015-08-06T10:45:16Z

Mcaubet at 10:44, 6 August 2015

2015-08-06T10:44:58Z

Mcaubet at 10:44, 6 August 2015

2015-08-06T10:44:29Z

Mcaubet at 10:44, 6 August 2015

2015-08-06T10:44:06Z

Mcaubet at 10:43, 6 August 2015

2015-08-06T10:43:44Z

Mcaubet at 10:18, 6 August 2015

2015-08-06T10:18:48Z

Mcaubet: /* Add a new token/space reservation */

2015-08-06T10:11:49Z

Add a new token/space reservation

Mcaubet: /* Add a new token/space reservation */

2015-08-06T10:11:19Z

Add a new token/space reservation

Mcaubet: /* Connect to dCache Admin interface */

2015-08-06T10:02:23Z

Connect to dCache Admin interface

Mcaubet: Created page with "=Connect to dCache Admin interface= You have two options to send commands to dCache: a) Using pcells, locate the SrmSpaceManager cell (under the srm-''machine''Domain). b)..."

2015-08-06T10:00:28Z

Created page with "=Connect to dCache Admin interface= You have two options to send commands to dCache: a) Using pcells, locate the SrmSpaceManager cell (under the srm-''machine''Domain). b)..."

New page

=Connect to dCache Admin interface=

You have two options to send commands to dCache:

a) Using pcells, locate the SrmSpaceManager cell (under the srm-''machine''Domain).

b) Logging to dccore.pic.es like this: "ssh -c blowfish -i /home/nagios/.ssh/identity -p 22223 -l admin dccore.pic.es"

=Add a new token/space reservation=
The command to a add a space reservation is <tt>reserve</tt>.

reserve [-vog=voGroup] [-vor=voRole] [-acclat=AccessLatency] [-retpol=RetentionPolicy] [-desc=Description] [-lgid=LinkGroupId] [-lg=LinkGroupName] <sizeInBytes> <lifetimeInSecs (use quotes around negative one)>

As an example, to add a token to Atlas Tier2 T2ATLASPRODDISK, with 4TB, and storage class t0d1:

reserve -vog=/atlas -vor=production -acclat=ONLINE -retpol=REPLICA -desc=T2ATLASPRODDISK 4000000000000 "-1"

=Modify/update a token/space reservation=
<pre>
update space reservation [-size=<size>] [-lifetime=<lifetime>] [-vog=<vogroup>] [-vor=<vorole>] <spaceToken>
# set new size and/or lifetime for the space token
# valid examples of size: 1000, 100kB, 100KB, 100KiB, 100MB, 100MiB, 100GB, 100GiB, 10.5TB, 100TiB
# see http://en.wikipedia.org/wiki/Gigabyte for explanation
# lifetime is in seconds ("-1" means infinity or permanent reservation
</pre>

As an example, to update Atlas Tier2 T2ATLASPRODDISK '''to 5TB''' we would (please, note that we '''do not''' add 5TB, we set the new space reservation to 5TB) :

<pre>
[dccore01.pic.es] (SrmSpaceManager) admin > ls -desc=T2ATLASPRODDISK
3517583 voGroup:/atlas voRole:production retentionPolicy:REPLICA accessLatency:ONLINE linkGroupId:4802067 size:4000000000000 created:Wed Jun 25 10:53:57 CEST 2008 lifetime:-1ms expiration:NEVER description:T2ATLASPRODDISK state:RESERVED used:1016764746531 allocated:0
[dccore01.pic.es] (SrmSpaceManager) admin >update space reservation -size=5TB 3517583
</pre>

It's 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).

=List tokens/space reservations=

* 2 ways:

:1. Per token:

[dccore01.pic.es] (SrmSpaceManager) admin > ls -desc=T2ATLASPRODDISK

:2 By showing all:

[dccore03.pic.es] (SrmSpaceManager) admin > ls

'''''Reservations:'''''
'''85046 voGroup:/atlas voRole:production retentionPolicy:REPLICA accessLatency:ONLINE linkGroupId:85047 size:10737418240 created:Fri Jul 25 15:34:25 CEST 2008 ''' ''lifetime:-1ms'' '''expiration:NEVER'''
''description:testGBA'' '''state:RESERVED used:792 allocated:0 '''
'''85048 voGroup:/atlas voRole:production retentionPolicy:REPLICA accessLatency:ONLINE linkGroupId:85047 size:10 created:Fri Jul 25 15:42:01 CEST 2008 '''''lifetime:-1ms''''' expiration:NEVER'''
''description:testGBA2'' '''state:RESERVED used:0 allocated:0 '''
'''total number of reservations: 2'''
'''total number of bytes reserved: 10737418250'''

LinkGroups:
90000 Name:linkgroup-pau FreeSpace:2196867381060 ReservedSpace:0 AvailableSpace:2196867381060 VOs:{/vo.pic.es:*} onlineAllowed:true nearlineAllowed:true replicaAllowed:true custodialAllowed:true outputAllowed:true UpdateTime:Wed May 06 12:15:41 CEST 2009(1241604941766
118114 Name:linkgroup-magic FreeSpace:1253068653025 ReservedSpace:0 AvailableSpace:1253068653025 VOs:{magic001:*}{/magic:*} onlineAllowed:true nearlineAllowed:true replicaAllowed:true custodialAllowed:true outputAllowed:true UpdateTime:Wed May 06 12:15:41 CEST 2009(1241604941766)
85047 Name:linkgroup-atlas FreeSpace:4393452420740 ReservedSpace:10737417458 AvailableSpace:4382715003282 VOs:{/atlas:production}{/atlas/soft-valid:production}{atlas001:*} onlineAllowed:true nearlineAllowed:true replicaAllowed:true custodialAllowed:true outputAllowed:true UpdateTime:Wed May 06 12:15:41 CEST 2009(1241604941766)
1 Name:linkgroup-alice-t0d1 FreeSpace:2196875766314 ReservedSpace:0 AvailableSpace:2196875766314 VOs:{alice001:*}{/alice:*} onlineAllowed:true nearlineAllowed:false replicaAllowed:true custodialAllowed:false outputAllowed:true UpdateTime:Wed May 06 12:15:41 CEST 2009(1241604941766)
55778 Name:linkgroup-dteam FreeSpace:3427855158643 ReservedSpace:0 AvailableSpace:3427855158643 VOs:{/dteam:*}{dteam001:*} onlineAllowed:true nearlineAllowed:true replicaAllowed:true custodialAllowed:true outputAllowed:true UpdateTime:Wed May 06 12:15:41 CEST 2009(1241604941766)
total number of linkGroups: 5
total number of bytes reservable: 13457381962324
total number of bytes reserved : 10737417458
last time all link groups were updated: Wed May 06 12:15:41 CEST 2009(1241604941766)

@@ Line 42: / Line 42: @@
   '''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 ==
+== List Link Groups ==
   '''ls link groups [-a] [-al=online|nearline] [-h] [-l] [-rp=output|replica|custodial] [name]'''

@@ Line 38: / Line 38: @@
   '''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]'''
 == List link groups ==

@@ Line 11: / Line 11: @@
 = 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'''
@@ 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.
-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
@@ 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.
-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>

@@ Line 4: / Line 4: @@
 == Connect to the SrmSpaceManager Admin Console ==
-a) Using '''pCells''', locate the '''''SrmSpaceManager''''' cell (under the srm-${hostname}Domain).
+* Two options:
-b) Logging to '''dccore.pic.es''' like this: '''''ssh -2 -x -o StrictHostKeyChecking=no -l admin -c blowfish -p 22224 dccore.pic.es'''''
+:'''a)''' Using '''pCells''', locate the '''''SrmSpaceManager''''' cell (under the srm-${hostname}Domain).

@@ Line 1: / Line 1: @@
-= Connect to dCache Admin interface =
+= Introduction =
-You have two options to send commands to dCache:
+* 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).
-= Add a new token/space reservation =
+= Managing the Space Reservation =
 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'''
@@ Line 19: / Line 21: @@
   reserve space -al=online -rp=replica -lg=linkgroup-atlas -owner=/atlas -desc=ATLASTESTDISK 4000000000000
-= Modify/update a token/space reservation =
+== Update a Space Reservation ==
-<pre>
-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'''
-</pre>
-As an example, to update the space reservation ATLASTESTDISK '''to 5TB''' we would (please, note that we '''do not''' add 5TB, we set the new space reservation to 5TB) :
+== Release Reservation ==
-<pre>
+ '''release space token'''
-It's 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).
+== List space reservations ==
-=List tokens/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]'''
-* 2 ways:
+= Other interesting commands =
-:1. Per token:
+== List link groups ==
-  [dccore01.pic.es] (SrmSpaceManager) admin > ls -desc=T2ATLASPRODDISK
+  '''ls link groups [-a] [-al=online|nearline] [-h] [-l] [-rp=output|replica|custodial] [name]'''
-:2 By showing all:
+== List File Reservations ==
- [dccore03.pic.es] (SrmSpaceManager) admin > ls
+  '''ls files [-a] [-h] [-limit=rows] [-owner=user|fqan] [-p] [-state=transferring|stored|flushed] ... [-token=long] [pnfsid|path]'''

@@ Line 8: / Line 8: @@
 =Add a new token/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 -rp=replica|custodial -lg=<name> -owner=user|fqan -desc=<string> -lifetime=<seconds>  <size>