DCache Administration Console Commands - Revision history

Eplanas: /* About this document */

2022-06-13T15:14:59Z

About this document

Mcaubet: /* File / replica management examples */

2017-07-31T10:02:56Z

File / replica management examples

Mcaubet: /* File / replica management */

2017-07-31T09:40:13Z

File / replica management

Mcaubet: /* Command help */

2017-07-31T09:39:43Z

Command help

Mcaubet: /* Command help */

2017-07-31T09:39:23Z

Command help

Mcaubet: /* Command help */

2017-07-31T09:38:55Z

Command help

Mcaubet: /* Command help */

2017-07-31T09:38:17Z

Command help

Mcaubet: /* Command help */

2017-07-31T09:38:02Z

Command help

Mcaubet: /* Command help */

2017-07-31T09:37:47Z

Command help

Mcaubet: /* Mover management */

2017-07-31T09:37:23Z

Mover management

@@ Line 2: / Line 2: @@
 * This document shows several examples of useful commands that can be run in the dCache Administration Console.
 * Administration console can be accessed through '''[[https://www.dcache.org/downloads/gui/ PCells GUI]]''' or through '''SSHv2''' as follows (in the example, '''dccore.pic.es''' is the physical machine running the '''admin''' cell):
-  ssh -2 -x -o StrictHostKeyChecking=no -l admin -c blowfish -p 22224 dccore.pic.es
+  ssh -2 -x -o StrictHostKeyChecking=no -l admin -p 22224 dccore.pic.es
 * In this document we show what we consider the most important commands for the everyday's administration tasks, and basically the ones that may be useful for the Manager On Duty. Maybe some important commands are missing, but will be added as soon as we detect that these may be important for the MoD.
 * This document is divided in two main blocks:
 # '''Pool commands''': shows useful commands that can be run on pools.
 # '''Service commands''': show useful commands that can be run on servers (this will include doors)
 = The basics =
 * If you access the Administration Console through '''SSHv2''' you should access to the different cells as follows:

← Older revision		Revision as of 10:02, 31 July 2017
Line 150:		Line 150:
	''rep sticky ls'' <pnfsid>		''rep sticky ls'' <pnfsid>
	=== File / replica management examples ===		=== File / replica management examples ===
		+	* Show all ''precious'' replicas:
		+	'''''[dccore01] (local) admin >''''' '''\s dc???_? rep ls -l=p'''
		+	00000F754EACA5F343A593669020CA14B742 <-P---------L(0)[1]> 2964602212 si={vo-cms.t1d0_Tau_data_raw}
		+	000094BC5C56FD6A4299A80A9A2D17972F0A <-P---------L(0)[0]> 4008986357 si={vo-cms.t1d0_Tau_data_raw}
		+	...
		+	* Delete replica ('''DO NOT delete non-cached-only files''')
		+	'''''[dccore01] (local) admin >''''' '''\s dc???_? rep rm <pnfsid>'''

← Older revision		Revision as of 09:40, 31 July 2017
Line 149:		Line 149:
	''rep set sticky [OPTIONS] [<pnfsid>] on\|off'' # change sticky flags		''rep set sticky [OPTIONS] [<pnfsid>] on\|off'' # change sticky flags
	''rep sticky ls'' <pnfsid>		''rep sticky ls'' <pnfsid>
		+	=== File / replica management examples ===

@@ Line 32: / Line 32: @@
 === Command help ===
   '''''[dccore01] (local) admin >''''' '''\s dc???_? help hsm'''
-  pool disable [options] [<errorCode> [<errorMessage>]] # suspend sending 'up messages'
+  ''pool disable [options] [<errorCode> [<errorMessage>]]'' # suspend sending 'up messages'
        OPTIONS :
          -fetch    #  disallows fetch (transfer to client)
@@ Line 40: / Line 40: @@
          -rdonly   #  := store,stage,p2p-client
          -strict   #  := disallows everything
-  pool enable # start sending 'up messages' again
+  ''pool enable'' # start sending 'up messages' again
-  pool suppress hsmload on|off
+  ''pool suppress hsmload on|off''
 === Disable / enable pool examples ===

@@ Line 75: / Line 75: @@
 === Command help ===
   '''''[dccore01] (local) admin >''''' '''\s dc???_? help hsm'''
-  mover kill <jobid>  # terminate a file transfer connection
+  ''mover kill <jobid>''  # terminate a file transfer connection
-  mover ls [-binary [jobId] ]
+  ''mover ls [-binary [jobId] ]''
-  mover queue ls [-l]  # list all mover queues in this pool
+  ''mover queue ls [-l]''  # list all mover queues in this pool
-  mover remove [<jobid>]  # #OBSOLETE command
+  ''mover remove [<jobid>]''  # #OBSOLETE command
-  mover set max active [OPTIONS] <maxactivemovers>  # set the maximum number of active client transfers
+  ''mover set max active [OPTIONS] <maxactivemovers>''  # set the maximum number of active client transfers
 === Mover management examples ===
 * Show current '''ftp''' transfers:

@@ Line 105: / Line 105: @@
 === Command help ===
   '''''[dccore01] (local) admin >''''' '''\s dc???_? help hsm'''
-  rep ls [-l[=s,l,u,nc,p]] [-s[=kmgt]] [-storage=<glob>] | <pnfsId>...
+  ''rep ls [-l[=s,l,u,nc,p]] [-s[=kmgt]] [-storage=<glob>] | <pnfsId>...''
     Format I  : <pnfsId>...
     Format II : [-l[=<selectionOptions>]] [-storage=<glob>] [-s]
@@ Line 141: / Line 141: @@
            x is epoch until which the entry is locked, 0 for non expiring lock
            y is the link count
-  rep rm <pnfsid> [-force] # removes the pnfsfile from the cache
+  ''rep rm <pnfsid> [-force]'' # removes the pnfsfile from the cache
-  rep rmclass <storageClass> # removes the from the cache
+  ''rep rmclass <storageClass>'' # removes the from the cache
-  rep set broken <pnfsid>
+  ''rep set broken <pnfsid>''
-  rep set cached <pnfsId> # DON'T USE, Potentially dangerous
+  ''rep set cached <pnfsId>'' # DON'T USE, Potentially dangerous
-  rep set precious <pnfsId>
+  ''rep set precious <pnfsId>''
-  rep set sticky [OPTIONS] [<pnfsid>] on|off  # change sticky flags
+  ''rep set sticky [OPTIONS] [<pnfsid>] on|off''  # change sticky flags
-  rep sticky ls <pnfsid>
+  ''rep sticky ls'' <pnfsid>

@@ Line 125: / Line 125: @@
     Output is a list of repository entries, one per line
     each line has the followin syntax:
-  <pnfsid> <state> <size> <storageinfo>
+      <pnfsid> <state> <size> <storageinfo>
     state is a sequence of state bits inclosed in angular "<>" brackets
     bit 1 is "C" if entry is cached or "-" if not

← Older revision		Revision as of 09:37, 31 July 2017
Line 100:		Line 100:
	'''''[dccore01] (local) admin >''''' '''\s dc???_? mover set max active -queue=ftp 400'''		'''''[dccore01] (local) admin >''''' '''\s dc???_? mover set max active -queue=ftp 400'''
	Max Active Io Movers set to 400		Max Active Io Movers set to 400
		+
		+	== File / replica management ==
		+	=== Command help ===
		+	'''''[dccore01] (local) admin >''''' '''\s dc???_? help hsm'''
		+	rep ls [-l[=s,l,u,nc,p]] [-s[=kmgt]] [-storage=<glob>] \| <pnfsId>...
		+	Format I : <pnfsId>...
		+	Format II : [-l[=<selectionOptions>]] [-storage=<glob>] [-s]
		+	Options :
		+	-l[=splunc] # selected list
		+	s : sticky files
		+	p : precious files
		+	l : locked files
		+	u : files in use
		+	nc : files which are not cached
		+	e : files which error condition
		+	-storage=<glob> # select only replicas
		+	of files with storage-
		+	info that matches <glob>
		+	-s[=kmgt] [-sum] # statistics
		+	k : data amount in KBytes
		+	m : data amount in MBytes
		+	g : data amount in GBytes
		+	t : data amount in TBytes
		+	Output is a list of repository entries, one per line
		+	each line has the followin syntax:
		+	<pnfsid> <state> <size> <storageinfo>
		+	state is a sequence of state bits inclosed in angular "<>" brackets
		+	bit 1 is "C" if entry is cached or "-" if not
		+	bit 2 is "P" if entry is precious or "-" if not
		+	bit 3 is "C" if entry is being transfered "from client" or "-" if not
		+	bit 4 is "S" if entry is being transfered "from store" or "-" if not
		+	bit 5 is "c" if entry is being transfered "to client" or "-" if not
		+	bit 6 is "s" if entry is being transfered "to store" or "-" if not
		+	bit 7 is "R" if entry is removed or "-" if not
		+	bit 8 is is always "-"
		+	bit 9 is "X" if entry is sticky or "-" if not
		+	bit 10 is "E" if entry is in error state or "-" if not
		+	bit 11 is "L(x)(y)" if entry is in locked or "-" if not
		+	x is epoch until which the entry is locked, 0 for non expiring lock
		+	y is the link count
		+	rep rm <pnfsid> [-force] # removes the pnfsfile from the cache
		+	rep rmclass <storageClass> # removes the from the cache
		+	rep set broken <pnfsid>
		+	rep set cached <pnfsId> # DON'T USE, Potentially dangerous
		+	rep set precious <pnfsId>
		+	rep set sticky [OPTIONS] [<pnfsid>] on\|off # change sticky flags
		+	rep sticky ls <pnfsid>