Difference between revisions of "DCache Administration Console Commands"

From Public PIC Wiki
Jump to navigation Jump to search
(Created page with "= About this document = * This document shows several examples of useful commands that can be run in the dCache Administration Console. * Administration console can be accesse...")
 
Line 4: Line 4:
 
  ssh -2 -x -o StrictHostKeyChecking=no -l admin -c blowfish -p 22224 dccore.pic.es
 
  ssh -2 -x -o StrictHostKeyChecking=no -l admin -c blowfish -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.
 
* 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:
 +
\? [command]...  # display help for shell commands
 +
\c cell[@domain] [user]  # connect to cell
 +
\exception [trace]  # controls display of stack traces
 +
\h [command]...  # display help for cell commands
 +
\l [cell[@domain]|pool/poolgroup]...  # list cells
 +
\q # quit
 +
'''\s (cell[@domain]|pool/poolgroup)[,(cell[@domain]|pool/poolgroup)]... command...  # send command'''
 +
\sl pnfsid|path command...  # send to locations
 +
\sn command...  # send pnfsmanager command
 +
\sp command...  # send poolmanager command
 +
\timeout [seconds]  # sets the command timeout
 +
* With '''\s''' you will be able to access to all '''cell[@domain]'''s, while branches of this command such like '''\sn''' or '''\sp''' are useful to directly access to the ''namespace'' or ''poolmanager'' cells without the needing of specifying the ''cell[@domain]''.
 +
== Pool commands ==
 +
=== Disable / enable pools ===
 +
pool disable [options] [<errorCode> [<errorMessage>]] # suspend sending 'up messages'
 +
      OPTIONS :
 +
        -fetch    #  disallows fetch (transfer to client)
 +
        -stage    #  disallows staging (from HSM)
 +
        -store    #  disallows store (transfer from client)
 +
        -p2p-client
 +
        -rdonly  #  := store,stage,p2p-client
 +
        -strict  #  := disallows everything
 +
pool enable # start sending 'up messages' again
 +
pool suppress hsmload on|off

Revision as of 08:44, 31 July 2017

About this document

  • This document shows several examples of useful commands that can be run in the dCache Administration Console.
  • Administration console can be accessed through [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
  • 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:
  1. Pool commands: shows useful commands that can be run on pools.
  2. 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:
\? [command]...  # display help for shell commands
\c cell[@domain] [user]  # connect to cell
\exception [trace]  # controls display of stack traces
\h [command]...  # display help for cell commands
\l [cell[@domain]|pool/poolgroup]...  # list cells
\q # quit
\s (cell[@domain]|pool/poolgroup)[,(cell[@domain]|pool/poolgroup)]... command...  # send command
\sl pnfsid|path command...  # send to locations
\sn command...  # send pnfsmanager command
\sp command...  # send poolmanager command
\timeout [seconds]  # sets the command timeout
  • With \s you will be able to access to all cell[@domain]s, while branches of this command such like \sn or \sp are useful to directly access to the namespace or poolmanager cells without the needing of specifying the cell[@domain].

Pool commands

Disable / enable pools

pool disable [options] [<errorCode> [<errorMessage>]] # suspend sending 'up messages'
     OPTIONS :
       -fetch    #  disallows fetch (transfer to client)
       -stage    #  disallows staging (from HSM)
       -store    #  disallows store (transfer from client)
       -p2p-client
       -rdonly   #  := store,stage,p2p-client
       -strict   #  := disallows everything
pool enable # start sending 'up messages' again
pool suppress hsmload on|off