File Catalog Interface

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:/>
    

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
    

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
    

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)