FileCatalog

5. File Catalog Interface

5.1 Starting the File Catalog Interface

• DIRAC File Catalog Command Line Interface (CLI) can be used to perform all the data management operations. You can start the CLI with the command:

  dirac-dms-filecatalog-cli
  

  For example:

  $ dirac-dms-filecatalog-cli
  Starting DIRAC FileCatalog client
  File Catalog Client $Revision: 1.17 $Date:
  FC:/>help
  
  Documented commands (type help <topic>):
  ========================================
  add    chmod  find   guid  ls     pwd       replicate  rmreplica   user
  cd     chown  get    id    meta   register  rm         size
  chgrp  exit   group  lcd   mkdir  replicas  rmdir      unregister
  
  Undocumented commands:
  ======================
  help
  
  FC:/>
  

5.2 Basic File Catalog operations

• Changing directory:

  FC:/>cd /vo.formation.idgrilles.fr/user/a/atsareg
  FC:/vo.formation.idgrilles.fr/user/a/atsareg>
  FC:/vo.formation.idgrilles.fr/user/a/atsareg>cd
  FC:/>cd /vo.formation.idgrilles.fr/user/a/atsareg
  FC:/vo.formation.idgrilles.fr/user/a/atsareg>cd ..
  FC:/vo.formation.idgrilles.fr/user/a>cd -
  

• Listing directory:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>ls -l
  -rwxrwxr-x 0 atsareg dirac_user      856 2010-10-24 18:35:18 test.txt
  

• Creating new directory:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>mkdir newDir
  FC:/vo.formation.idgrilles.fr/user/a/atsareg>ls -l
  -rwxrwxr-x 0 atsareg dirac_user      856 2010-10-24 18:35:18 test.txt
  drwxrwxr-x 0 atsareg dirac_user        0 2010-10-24 11:00:05 newDir
  

• Changing ownership and permissions:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>chmod 755 newDir
  FC:/vo.formation.idgrilles.fr/user/a/atsareg>ls -l
  -rwxrwxr-x 0 atsareg dirac_user      856 2010-10-24 18:35:18 test.txt
  drwxr-xr-x 0 atsareg dirac_user        0 2010-10-24 11:00:05 newDir
  

5.3 Managing files and replicas

• Upload a local file to the grid storage and register it in the catalog:

  add <LFN> <local_file> <SE>
  

  For example:

  FC:/>cd /vo.formation.idgrilles.fr/user/a/atsareg
  FC:/vo.formation.idgrilles.fr/user/a/atsareg> add test.txt test.txt DIRAC-USER
  File /vo.formation.idgrilles.fr/user/a/atsareg/test.txt successfully uploaded to the DIRAC-USER SE
  FC:/vo.formation.idgrilles.fr/user/a/atsareg> ls -l
  -rwxrwxr-x 0 atsareg dirac_user      856 2010-10-24 18:35:18 test.txt
  

• Download grid file to the local directory:

  get <LFN> [<local_directory>]
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>get test.txt /home/atsareg/data
  File /vo.formation.idgrilles.fr/user/a/atsareg/test.txt successfully downloaded
  

• Replicate a file registered and stored in a storage element to another storage element:

  replicate <lfn> <SE>
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>replicate test.txt M3PEC-disk
  File /vo.formation.idgrilles.fr/user/a/atsareg/test.txt successfully replicated to the M3PEC-disk SE
  

• List replicas:

  replicas <LFN>
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>replicas  test.txt
  lfn: /vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  M3PEC-disk      srm://se0.m3pec.u-bordeaux1.fr:8446/srm/managerv2?SFN=/dpm/m3pec.u-bordeaux1.fr/home/vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  DIRAC-USER      dips://dirac.in2p3.fr:9148/DataManagement/StorageElement/vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  

• Remove replicas:

  rmreplica <LFN> <SE>
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>rmreplica test.txt M3PEC-disk
  lfn: /vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  Replica at M3PEC-disk moved to Trash Bin
  FC:/vo.formation.idgrilles.fr/user/a/atsareg>replicas test.txt
  lfn: /vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  DIRAC-USER      dips://dirac.in2p3.fr:9148/DataManagement/StorageElement/vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  

• Remove file:

  rm <LFN>
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>rm test.txt
  lfn: /vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  File /vo.formation.idgrilles.fr/user/a/atsareg/test.txt removed from the catalog
  

• Remove directory:

  rmdir <path>
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>rmdir newDir
  path: /vo.formation.idgrilles.fr/user/a/atsareg/newDir
  Directory /vo.formation.idgrilles.fr/user/a/atsareg/newDir removed from the catalog
  

5.4 Getting extra information

• Getting file or directory size:

  size <LFN>
  size <dir_path>
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>size test.txt
  lfn: /vo.formation.idgrilles.fr/user/a/atsareg/test.txt
  Size: 856
  FC:/vo.formation.idgrilles.fr/user/a/atsareg>size ..
  directory: /vo.formation.idgrilles.fr/user/a
  Size: 2358927
  

• Your current identity:

  id
  

  For example:

  FC:/vo.formation.idgrilles.fr/user/a/atsareg>id
  user=1(atsareg) group=2(dirac_user)